验签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
query	接口查询参数	条件必须	query和body至少传递一个，格式：{"p":"a", "d":"h"}
body	接口请求体参数	条件必须	query和body至少传递一个，格式：ssasajdfussd
sign	SDK返回的签名	必须

请求示例

以中国区站点为例：

curl --location 'https://cn.apitd.net/signature/v1?partner_code=demo&partner_key=xxxxxxxxxxxxx'
--header 'Content-Type: application/x-www-form-urlencoded'
--data-urlencode 'sign=gd38ffb06c31c1e9aad73f1f0269694fcec9500542c3b71defb50dab41'
--data-urlencode 'path=123'
--data-urlencode 'query={"p":"a","d":"h"}'

响应格式

字段	类型	含义	建议	备注
code	Integer	API 状态码	必须	200代表成功，其他代表失败
desc	String	状态信息	必须	在 API 异常状态下会输出具体的异常原因
result	String	业务结果	必须	具体返回参考下文

RESULT格式

字段	类型	含义	建议	备注
code	Integer	业务状态码	必须	参考下文业务API状态码(RESULT.CODE)说明
env	Array	状态信息	必须	设备风险，枚举值：{root，hack，virtualEnv}
result	String	业务结果	必须	验签结果，枚举值：{pass，block，miss}
version	String	服务版本号	必须	v1

业务API状态码(RESULT.CODE)

code	结果	说明
1101	miss	sign缺失
1102	miss	path缺失
1103	miss	请求报文query或者body缺失
1200	pass	验签通过
1301	block	数据格式不合法
1401	block	验签失败
1402	block	验签失败
1403	block	验签失败
1403	block	验签失败
1501	block	验签失败
1502	block	验签失败
1503	block	验签失败
1601	pass	验签成功，但命中了设备风险

响应示例

{
	"code": 200,
  "desc": "",
  "result": {
  	"code": 1200,
    "env": [],
    "result": "pass",
    "version": "v1"
}