验签API

Base URL

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"
}