网站技术文档模板-2.为什么要写socket文件?

1. 接口文档有哪些

项目开发总结中,web项目的前端是单独开发的。 应用程序的开发需要前端工程师共同定义socket并编写socket文档。 之后大家就按照这个socket文档进行开发并维护,直到项目结束。

2.为什么要写socket文件?

(1)项目开发过程中,前端和后端工程师有统一的档案进行沟通和开发

(2)项目维护时或项目人员更换时,方便后期人员查看和维护

3.复习socket的知识

要了解套接字文档的规范,首先必须了解套接字。 接口分为请求方法、url、请求参数、返回参数四部分:

(1)方法:常用的方法有以下四种: GET PUT POST DELETE

(2)url:以/a开头,如果需要登录可调用的socket(如添加、修改;前台用户个人信息、资金信息等),需要添加/ u 后面,即:/a/u; 通常会在中间放入表名或者能够表达这个接口的短语。 get方法中,如果是后台搜索查询列表网站技术文档模板,则以/search结尾,如果是前台搜索查询列表,则以/list结尾。 uri地址的外观并不逊色于大写字母。 如果两个单词拼接,用/分隔

(3)请求参数和返回参数:请求参数和返回参数都分为5栏:字段、描述、类型、备注、必填。

字段:类的属性

说明:中文翻译

Type:属性的类型,只有String、Number、Object、Array四种

备注:一些解释性语言网站技术文档模板,或者写一个简单的例子

(4)返回参数要分两种情况讨论:

只返回socket调用成功或失败:代码、原因

返回参数:字段、类型

3. 常见问题

标准化套接字文档中应包含哪些内容

4. 解决方案

除了上面提到的请求方法、url、请求参数、返回参数外,还应该添加socket示例、接口文档版本号、版本变更内容、版本变更时间、修改人、错误码等。

5. 示例:

这是在网站上找到的套接字文档的示例