### 接口编写规范 #### 返回值的规范 ``` json { 'code':200, "message":"", "data":[ { "title":"xxx", "content":"xxx", }, { "title":"xxx", "content":"xxx", } ] } { 'code':200, "message":"", "data":{ "title":"xxx", "content":"xxx", }, } ``` #### 状态码的规范 1.200：成功 2.401:没有授权 3.400:参数错误 4.500:服务器内部错误 --- 实例: 定义好规范类接口 ``` # coding:utf-8 from flask import jsonify # 定义状态码 class HttpCode(object): ok = 200 paramserror = 400 unautherror = 401 servererror = 500 def restful_result(code,message,data): return jsonify({ "code":code, "message":message, "data":data, }) def success(message="",data=None): return restful_result(code=HttpCode.ok,message=message,data=data) def unauth_error(message=""): return restful_result(code=HttpCode.unautherror,message=message,data=None) def params_error(message=""): return restful_result(code=HttpCode.paramserror,message=message,data=None) def server_error(message=""): return restful_result(code=HttpCode.servererror,message=message or '服务器内部错误',data=None) ``` ``` # return jsonify({"code":400,"message":"旧密码错误"}) return restful.params_error('旧密码错误!') 这样能够让代码更加规范，减少重复写代码 ```