这篇文章给大家分享的是有关Django如何自动生成api接口文档的内容。小编觉得挺实用的，因此分享给大家做个参考，一起跟随小编过来看看吧。
最近在写测试平台，需要实现一个节点服务器的api,正好在用django，准备使用djangorestframework插件实现。
需求
实现一个接口，在调用时，通过传递的参数，直接运行对应项目的自动化测试
环境
Python3.6 ,PyCharm,W7
项目结构
功能实现
流程
我们要做的就是实现以上流程
安装
计算
安全
数据库
网络和加速
企业服务
pip install djangorestframework
pip install markdown
pip install django-filter # Filtering support配置
INSTALLED_APPS = (
...
'rest_framework',
)编写代码(本次代码不涉及数据库操作，只简单的写一个api)
①:打开AutoApi/Api/views.py 编写如下代码
from django.http import JsonResponse, HttpResponseNotAllowed, HttpResponse
from django.views.decorators.csrf import csrf_exempt
from rest_framework.parsers import JSONParser
from rest_framework import status
@csrf_exempt
def run_job(request):
# 判断请求头是否为json
if request.content_type != 'application/json':
# 如果不是的话，返回405
return HttpResponse('only support json data', status=status.HTTP_415_UNSUPPORTED_MEDIA_TYPE)
# 判断是否为post 请求
if request.method == 'POST':
try:
# 解析请求的json格式入参
data = JSONParser().parse(request)
except Exception as why:
print(why.args)
else:
content = {'msg': 'SUCCESS'}
print(data)
# 返回自定义请求内容content,200状态码
return JsonResponse(data=content, status=status.HTTP_200_OK)
# 如果不是post 请求返回不支持的请求方法
return HttpResponseNotAllowed(permitted_methods=['POST'])②:打开AutoApi/Api/urls.py 编写如下代码
from django.conf.urls import url
from Api import views
urlpatterns = [
url(r'^runJob/$',views.run_job),
]③:打开AutoApi/AutoApi/urls.py 修改如下代码
ALLOWED_HOSTS = '*' # 修改为* 代码允许任意host
from django.conf.urls import url,include
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^',include('Api.urls')),# 新增
]④:启动服务
python manage.py runserver 0.0.0.0:8080
⑤:我们请求试试看
感谢各位的阅读！关于“Django如何自动生成api接口文档”这篇文章就分享到这里了，希望以上内容可以对大家有一定的帮助，让大家可以学到更多知识，如果觉得文章不错，可以把它分享出去让更多的人看到吧！
亿速云「云服务器」，即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘，价格低至29元/月。点击查看>>
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。
