026_生成自己项目的API文档

一、什么是API

  API即Application Programming Interface的首字母缩写、应用程序编程接口。

二、常用的注释标签

  在生成API之前我们需了解一下jdk为我们提供的几个注释标签

    @Author 作者

    @version 版本

    @param  参数

    @return  返回值的含义

    @throws 抛出异常描述

    @deprecated 废弃。建议用户不在使用该方法

三、如何生成自己项目的API

  生成项目的API之前一定要使用文档注释、及/** 注释内容*/

  a)右键单击项目,选中export

    

生成后的API文档截图如下:

  

 

转载于:https://www.cnblogs.com/aeon/p/9932965.html

生成 Django API 接口文档一般可以通过以下步骤实现: 1. 安装 Django-rest-swagger 可以通过 pip 安装 Django-rest-swagger: ``` pip install django-rest-swagger ``` 2. 添加 Django-rest-swagger 到 INSTALLED_APPS 在 settings.py 文件中添加 Django-rest-swagger 到 INSTALLED_APPS: ```python INSTALLED_APPS = [ ... 'rest_framework', 'rest_framework_swagger', ... ] ``` 3. 添加 Django-rest-swagger 的 URL 到项目的 URL 配置文件 在项目的 URL 配置文件(例如 urls.py)中添加 Django-rest-swagger 的 URL: ```python from rest_framework_swagger.views import get_swagger_view schema_view = get_swagger_view(title='API 文档') urlpatterns = [ ... url(r'^docs/$', schema_view), ... ] ``` 4. 添加 API 文档注释 在 API 视图函数中,添加类似以下的注释,用于生成 API 文档: ```python from rest_framework.decorators import api_view, schema from rest_framework.response import Response from rest_framework.schemas import AutoSchema @api_view(['GET']) @schema(AutoSchema(manual_fields=[ coreapi.Field(name="param1", required=True, location='query', schema=coreschema.Integer()), coreapi.Field(name="param2", required=True, location='query', schema=coreschema.Integer()), ])) def my_api_view(request): """ API endpoint documentation example. --- parameters: - name: param1 description: Parameter description required: true type: integer paramType: query - name: param2 description: Parameter description required: true type: integer paramType: query """ # Implementation return Response(...) ``` 5. 运行项目 运行项目后,访问 http://localhost:8000/docs/ 即可看到生成API 文档。 以上步骤是生成 Django API 接口文档的一种方法,也可以使用其他的工具或框架来实现。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值