美文网首页
后端接口文档

后端接口文档

作者: twentyshaw | 来源:发表于2019-07-20 21:43 被阅读0次

关于后端接口文档

一般包含以下内容:

  1. 该接口的路径
  2. 该接口提交的数据类型,如:

GET: 获取数据
POST: 提交或者创建
PATCH: 修改数据,部分修改
DELETE :删除数据
PUT: 修改数据,整体替换原有数据

  1. 参数类型/格式,比如是json格式,还是application/x-www-form-urlencoded的数据

  2. 参数字段及限制条件
    参数字段:就是该参数想提交给服务端需要哪些数据(字段),比如用户验证接口,就需要提交用户的id,密码;创建博客的接口,需要提交博客的标题,介绍与内容。
    限制条件:比如提交的用户名必须是多长,不能使用哪些字符

  3. 返回成功的数据格式

  4. 返回失败的数据格式

  5. 后端接口线上地址的根路径
    可以是开发环境的的线上路径,也可以是项目真正发布后的线上路径

相关文章

  • 2018年大四生产实习接口文档

    六. 后端接口文档 6.1 接口文档说明 由于该项目为前后端分离项目且接口符合 RESTful API 规范,项目...

  • 【融职培训】Web前端学习 第9章 教务管理系统开发3 接口文档

    一、接口文档简介 在项目开发中,web项目的前后端分离开发,需要由前后端工程师共同定义接口,编写接口文档,之后大家...

  • Springboot 项目集成Swagger

    相信无论是前端还是后端开发,都或多或少地被接口文档折磨过。前端经常抱怨后端给的接口文档与实际情况不一致。后端又觉得...

  • spring boot2.0整合 swagger2.9

    Swagger作用 在前后端分离中,API接口文档的纽带作用显得尤为重要。后端甩给前端一份接口文档,前端就知道传入...

  • REST API文档工具Swagger2,以及与SpringBo

    手写Api文档的几个痛点: 前后端联调接口,需要不断的更新接口文档,一般是文档跟不上接口变化的节奏; 接口返回结果...

  • 后端接口文档

    关于后端接口文档 一般包含以下内容: 该接口的路径 该接口提交的数据类型,如: GET: 获取数据POST: 提交...

  • Swagger介绍及使用

    导语: 相信无论是前端还是后端开发,都或多或少地被接口文档折磨过。前端经常抱怨后端给的接口文档与实际情况不一致。后...

  • SpringBoot集成Swagger2

    前言 前端经常抱怨后端给的接口文档与实际情况不一致。 后端又觉得编写及维护接口文档会耗费不少精力,经常来不及更新。...

  • 接口测试必须要知道的

    1. Tips 接口就是一个文档,接口规范是架构师指定的 接口测试主要是测试后端,验证后端编写的程序(业务逻辑)是...

  • SpringBoot整合Swagger2,再也不用维护接口文档了

    前后端分离后,维护接口文档基本上是必不可少的工作。一个理想的状态是设计好后,接口文档发给前端和后端,大伙按照既定的...

网友评论

      本文标题:后端接口文档

      本文链接:https://www.haomeiwen.com/subject/ndqplctx.html