API 接口书写心得

背景:

定义 CMTeam 的生成测试、生成计划、题目优化(timer 触发)的接口,接口规则同产品开发组(文档可找我来取),建议提前阅读如下内容:

阅读以下链接:
https://hackernoon.com/restful-api-designing-guidelines-the-best-practices-60e1d954e7c9

https://www.snyxius.com/blog/21-best-practices-designing-launching-restful-api/#.WUJcEROGOHo

编辑工具

推荐使用在线编辑:
http://editor.swagger.io/

概念

  1. API 要基于前端页面请求,而非已有的函数模块。凡是产品开发组需要调用的函数,都需要写成 url 的形式。
  2. 资源的概念。Paper,Plan,Institution,Class,User

书写规范

见标准文档。

报错指南

见标准文档。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容