使用apiDoc实现python接口文档编写(python制作api接口)

网友投稿 661 2022-06-06


apiDoc的安装

npm install apidoc -g

点击官方文档

生成api的终端命令:apidoc -i 代码所在路径-o 生成文件的路径

接口文档的编写

文件的简介

project的介绍写在单独的json文件中apidoc.json:

{ "name": "project_name",

 "version": "0.1.0",

 "description": "who am i ,what i can do ",

 "title": " title of the html that generated by apiDoc",

 "sampleUrl" : "https://127.0.0.1:8000"}

具体api的书写模版

"""
@api {methods} url description
@apiName unique_name
@apiGroup group

@apiParam {type} field description

@apiSuccessExample {json} Success-Response:
HTTP/1.1 200 OK
  {
  "errno":200,
  "errmsg":errmsg,
  }
@apiError errortype description.
@apiErrorExample {json} Error-Response:
 HTTP/1.1 200 OK
 {
  "errno":401
  "errmsg": "UserNotFound"
  }
"""

以上这篇使用apiDoc实现python接口文档编写就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持。

您可能感兴趣的文章:
  • Python3使用 GitLab API 进行批量合并分支
  • 使用Python FastAPI构建Web服务的实现
  • 基于python图像处理API的使用示例
  • Python如何使用Gitlab API实现批量的合并分支
  • Python Gitlab Api 使用方法
  • Python使用百度api做人脸对比的方法
  • python使用adbapi实现MySQL数据库的异步存储
  • Python使用Windows API创建窗口示例【基于win32gui模块】
  • Python使用百度API上传文件到百度网盘代码分享
  • python3 kubernetes api的使用示例


版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:通过Nginx代理转发配置实现跨域的方法(API代理转发)(nginx反向代理跨域配置)
下一篇:Django 自动生成api接口文档教程(django开发一个管理系统)
相关文章

 发表评论

暂时没有评论,来抢沙发吧~