跳转到内容

API接口文档

接口地址

http://127.0.0.1:7071

服务端需要传token参数,通过get或post方式传递均可

bash
# GET方式
GET /api/example?token=xxxx

token可在设置页面中api密钥获取

传参数格式约定

所有参数通过FORM表单中的data参数以JSON字符串的格式传递

PS:后端会严格验证参数的字段格式及其数据类型,请严格按要求传递参数

HTTP
Content-Type: application/x-www-form-urlencoded
data=JSON.stringify(args)

示例:
let args = {
    name:"test",
    sex:1
}

let url = '/api/generate'

post(url,args,function(res){
    console.log(res)
})

响应格式约定

PS:以下是非流程响应的约定,如果是流式响应,是直接响应内容的

字段类型说明
statusint状态,0=成功,-1=失败,请结合code和error_msg字段处理
codeint状态码,请参考第三节:响应状态码参考
msgstring响应消息提示,通常是可被理解的提示信息
error_msgstring错误信息,status==false 时此字段可能有值,通常是详细的错误信息,此消息主要用于排查异常
messageany返回的数据,不需要返回数据时,可能为null