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. 示例:
这是在网站上找到的套接字文档的示例
发表评论