接口文档模版(Markdown版)

news/2024/11/29 3:52:45/

场景

最近又又又得给第三方系统写接口文档,需要一个Restful接口模版参考参考。

接口文档模版

# ERP 服务## 监控### 数据`POST /system/xxx/getData`请求参数:| 字段名     | 类型   | 位置 | 描述                 |
| ---------- | ------ | ---- | -------------------- |
| params| string | body | 父节点     |
| params.beginTime| string | body | 查询开始时间     |
| params.endTime | String    | body |查询结束时间 |请求示例:```bash
curl --location --request POST 'http://xxxx/system/xxx/getData' \
--header 'Content-Type: application/json' \
--data-raw '{"params": {"beginTime": "2021-10-12","endTime": "2021-11-12"}
```响应参数:| 字段名 | 类型   | 位置 | 描述     |
| ------ | ------ | ---- | -------- |
| code   | Int    | body | 状态码   |
| msg    | string | body | 消息描述 |
| data    | json | body | 返回数据 |
| data.visitorsCount    | Long | body | 访问数 |
| data.registerCount    | Long | body | 注册数 |
| data.providerCount    | Long | body | 服务商数 |响应示例:```json
{"msg": "操作成功","code": 200,"data": {"visitorsCount": 5, "registerCount": 6, "providerCount": 6  }
}
```

总结

上面就是接口文档模版内容。


http://www.ppmy.cn/news/1086686.html

相关文章

2023年MySQL-8.0.34保姆级安装教程

重点放前面:演示环境为windows环境。 MySQL社区版本安装教程如下: 一、MySQL安装包下载二、安装配置设置三、配置环境变量 大体分为3个步骤:①安装包的下载;②安装配置设置;③配置环境变量 一、MySQL安装包下载 下载官…

点击按钮时触发防抖

当在React中点击按钮时触发防抖,并传递一个ID作为参数,你可以使用useRef和useCallback钩子来实现。 import React, { useState, useRef, useCallback } from react;const ButtonComponent () > {const [clickCount, setClickCount] useState(0);co…

Linux之基于HTTPS的静态网站

目录 Linux之基于HTTPS的静态网站 定义 SSL协议 使用Apachemod_ssl组件的加密认证网站 mod_ssl模组 安装 配置文件 ssl配置文件的主要参数 案例 案例1 --- 搭建HTTPSSL的加密认证的web服务器 案例2 --- 组建多个子目录的网站www.joker.com,该网站下有2个子…

npm install依赖冲突解决办法

今天npm的时候发现报错,原来是依赖冲突了 npm后面加上这个指令就可以顺利的安装依赖了。问题主因就是不同开发用了不同版本node导致依赖版本不同,出现了成功冲突,这是段指令;它告诉npm忽略项目中引入的各个依赖模块之间依赖相同但…

持续集成与持续交付(CI/CD):探讨在云计算中实现快速软件交付的最佳实践

文章目录 持续集成(CI)的最佳实践持续交付(CD)的最佳实践云计算环境下的特别注意事项 🎈个人主页:程序员 小侯 🎐CSDN新晋作者 🎉欢迎 👍点赞✍评论⭐收藏 ✨收录专栏&am…

逐鹿人形机器人,百度、腾讯、小米卷起来

长期不温不火的人形机器人产业迎来新风口,技术显著提升、新品层出不穷、资本投资态度也逐渐好转。 8月18日,2023世界机器人大会博览会正式开放,全面展示了机器人行业的新技术、新产品和新应用。据悉,此次展会展览总面积达4.5万平…

迪米特法则(Law of Demeter)

迪米特法则(LoD, Law of Demeter),又叫最少知识原则(Least Knowledge Principle,LKP),指一个对象对其它对象应该尽可能少地理解。 迪米特法则也描述为只与最直接的朋友讲话、不要跟陌生人讲话。…

BootStrap框架

一、媒体查询 1. 基本语法 根据设备宽度的变化,设置差异化样式 1. 1 开发常用写法,媒体特性常用写法: max-widthmin-width media (媒体特性) {选择器 {样式} }1. 2 书写顺序 min-width(从小到大)max-width&#…