鉴权认证

💡

在调用豆绘AI API前，必须获取签名，签名是用户的访问令牌，包含了用户的身份、权限等信息，每个API的请求头都需要加上该签名信息。鉴权主要分为以下两步：

获取appid、appsecret。

获取签名。

获取 appid、appsecret

当您开通权限之后，客服会向您提供平台的appid、appsecret，为了您的财产和服务安全请您妥善保管。

签名流程

签名步骤

创建签名

创建签名原文{"appid":"appid","version":"2.0.0","timestamp":当前时间戳(精确到秒)} （字段按字母顺序排序），使用密钥进行md5签名处理(小写32位)。

将签名加到请求头，发起API请求

在Request Header中的添加 Authorization 字段，字段值格式为
{"version":"2.0.0","timestamp":"当前时间戳(精确到秒)","appid":"你的appid","sign":"签名sign"}

发起API请求

API鉴权成功，Http状态码会返回200

重要提示:
本文档中提供的所有接口均面向开发者服务器端调用，用于计算身份签名校验的 AppSecret 开发者应妥善保管,可在应用的服务器端存储和使用，但不应存储或传递到客户端，也不应在网页等前端代码中嵌入。
如泄露，请联系我们更新。

💡

接口请求前缀（v1.1版本，含公共接口）：
https://api.douhuiai.com/
接口请求前缀（v2.0版本）：
https://dhd.douhuiai.com/

签名算法：MD5 32位小写 不同语言自行转换
sign = md5("你的appid"+"timestamp"+"version"+"你的appsecret")

例如：

参数如下：

签名算法：md5(dh9tc2n4beadbn8xby17359861562.0.0uyt48qs656mubr7vf3cw68ky2nc5nhrz)算出，
sign值为：fc9a8e9c6935d6d78bfa6f1fa2953c38

接口请求体

如下：

headers = {
  'Authorization': '{
       "appid": "dh9tc2n4beadbn8xby",
       "timestamp: 1735986156,
       "version": "2.0.0",
       "sign":"fc9a8e9c6935d6d78bfa6f1fa2953c38"
  }'
}

校验与用例一致，则表示通过。

PHP demo示例

Python demo示例

Go demo示例

业务响应报文

业务返回值http状态码都是200，业务异常在body下面的code上标识

业务正确

业务错误

鉴权错误

状态码

状态码	描述
200	业务正确
500	业务错误，具体信息看`message`字段
10000	API鉴权错误，具体信息看`message`字段

业务响应报文#

状态码#

业务响应报文

状态码