API Reference
English

验签API

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

认证参数

字段类型含义建议备注
partner_codeString合作方标识必须由 TD 分配
partner_keyString合作方密钥必须由 TD 分配

请求参数

字段含义建议备注
path接口路径必须/path/goods/getValuequery
signSDK返回的签名必须
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"
}'

响应格式

字段类型含义备注
codeIntegerAPI 状态码参考下文API状态码说明
messageString状态信息
dataJson验签结果参考下文验签结果说明

API状态码说明

错误码原因
200请求成功
431partner缺失
500服务器内部异常
512未购买此服务
513流量已被禁用

验签结果说明

字段类型含义备注
statusInteger验签结果码参考下文验签结果码
envArray设备风险root:提权行为
hack:环境攻击行为
virtualEnv:虚拟执行
crawler:网络爬虫
resultString验签结果miss:缺失
block:拦截
pass:通过
versionString版本号

验签结果码说明

code结果说明
1101misssign缺失
1102misspath缺失
1200pass验签通过
1301block数据格式不合法
1302block数据格式不合法
1303block数据格式不合法
1304block数据格式不合法
1401block验签失败
1402block验签失败
1501block验签失败
1502block验签失败
1503block验签失败
1601pass验签成功,但命中了设备风险
1602pass验签通过,请求频繁
1603pass验签通过,请求重放

成功示例

{
  "code": 200,
  "message":"success",
  "data": {
    "status":1200,
    "env": [],
    "result": "pass",
    "version": "v2"
  }
}

失败示例

{
    "code": 512,
    "message": "This service is not purchased"
}