Base URL
- 中国节点:https://cn.apitd.net/signature/v2
- 美国节点:https://us.apitd.net/signature/v2
- 新加坡节点:https://sg.apitd.net/signature/v2
- 德国节点:https://de.apitd.net/signature/v2
API
URL | 请求方式 | Content-Type | 输出格式 | 字符集 |
---|---|---|---|---|
api-base-url?partner_code=xxx&partner_key=xxx | POST | application/json | JSON | UTF-8 |
认证参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
partner_code | String | 合作方标识 | 必须 | 由 TD 分配 |
partner_key | String | 合作方密钥 | 必须 | 由 TD 分配 |
请求参数
字段 | 含义 | 建议 | 备注 |
---|---|---|---|
path | 接口路径 | 必须 | /path/goods/getValuequery |
sign | SDK返回的签名 | 必须 | |
query | 查询参数 | 可选,跟SDK加签保持一致 | 格式参考:{"key1":"asas", "key2":"2"} |
body | 请求报文 | 可选,跟SDK加签保持一致 | 格式参考:asdfga |
请求示例
以中国区站点为例:
curl --location 'https://cn.apitd.net/signature/v2?partner_code=demo&partner_key=xxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"path": "p",
"sign": "g91b0e2ce42957a4b9d2d6b78b63f6fbf31df1117ecee4a96872757c51595d53674ed72ea7df1e1cead879e407021b29e4204cf7e755174e4ab1f4e35d9abb4400000000000022016906d21a40a80cb9a1949500"
}'
响应格式
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
code | Integer | API 状态码 | 参考下文API状态码说明 |
message | String | 状态信息 | |
data | Json | 验签结果 | 参考下文验签结果说明 |
API状态码说明
错误码 | 原因 |
---|---|
200 | 请求成功 |
431 | partner缺失 |
500 | 服务器内部异常 |
512 | 未购买此服务 |
513 | 流量已被禁用 |
验签结果说明
字段 | 类型 | 含义 | 备注 |
---|---|---|---|
status | Integer | 验签结果码 | 参考下文验签结果码 |
env | Array | 设备风险 | root:提权行为 hack:环境攻击行为 virtualEnv:虚拟执行 crawler:网络爬虫 |
result | String | 验签结果 | miss:缺失 block:拦截 pass:通过 |
version | String | 版本号 |
验签结果码说明
code | 结果 | 说明 |
---|---|---|
1101 | miss | sign缺失 |
1102 | miss | path缺失 |
1200 | pass | 验签通过 |
1301 | block | 数据格式不合法 |
1302 | block | 数据格式不合法 |
1303 | block | 数据格式不合法 |
1304 | block | 数据格式不合法 |
1401 | block | 验签失败 |
1402 | block | 验签失败 |
1501 | block | 验签失败 |
1502 | block | 验签失败 |
1503 | block | 验签失败 |
1601 | pass | 验签成功,但命中了设备风险 |
1602 | pass | 验签通过,请求频繁 |
1603 | pass | 验签通过,请求重放 |
成功示例
{
"code": 200,
"message":"success",
"data": {
"status":1200,
"env": [],
"result": "pass",
"version": "v2"
}
}
失败示例
{
"code": 512,
"message": "This service is not purchased"
}