签名授权+webhook事件相关信息文档
基本说明
正式环境HOST：https://ta-api-cn.dji.com 接口使用该域名
鉴权相关
| 关键事项 | 细节 | 补充说明 |
|---|---|---|
| 签名内容 | webapi | 第三方调用DJI，无人机信息获取、无人机的控制 |
| 签名 内容 | webhook | DJI通知到第三方，特别是公有云，需要防止通知信息被篡改 |
| 签名细节 | 签名版本号 | 方便后续升级，第一阶段先不考虑 |
| 签名字符串 | X-DJI-Signature | |
| 签名字段 | X-DJI-Timestamp X-DJI-Nonce Method | |
| 签名算法 | webapi | HmacSHA256("AK+Method+X-DJI-Timestamp+X-DJI-Nonce",SK),注意输出为hex字符串 |
| webhook | HmacSHA256("AK+X-DJI-Timestamp+X-DJI-Nonce+event_type+sub_type",SK),注意输出为hex字符串 |
WebAPI
| 字段名 | 类型 | 字段说明 | 具体说明 |
|---|---|---|---|
| code | int32 | 业务错误码 | 0--接口正常返回，非0--接口错误返回 |
| message | string | 业务错误码文案 | 具体的error message,code 为0的时候空串 |
| data | object | 具体返回内容 | 具体返回与接口有关 |
WebHook
method: POST
| 字段名 | 类型 | 字段说明 | 具体说明 |
|---|---|---|---|
| group_id | string | 通知事件所属的团队 | 团队ID |
| event_type | string | 通知事件类型 | device--设备类通知事件，task--任务类通知事件 mission--航线类通知事件 |
| sub_type | string | 通知事件子类型 | device事件下，分别有osd、state、hms、progress、topo、bind类 task事件下，分别有status、statistics子事件 wayline事件下有create、update、delete子事件 |
| timestamp | int64 | 通知时间戳 | 13位毫秒时间戳 |
| data | object | 具体细节内容 | 具体事件可以参考具体内容 |
修改于 2025-12-17 08:15:33