中外链-翼检通合作对接文档
PARTNER API · V1.0

中外链 × 翼检通
合作平台对接文档

面向合作方的接口接入说明，涵盖请求地址、签名生成、调用示例与响应字段。

TEST ENVIRONMENT
https://qc-test.wingtrade.com/api
PRODUCTION ENVIRONMENT
https://qc.wingtrade.com/api
文档版本　V1.0修订日期　2024-06-26修订说明　合作平台对接文档初版
01 · AUTHENTICATION

签名方式

平台向合作方提供 appId 与对应的 secret。合作方使用当前时间戳（13 位）、appId、appSecret 生成签名，并将最终结果放入请求头。

STEP 01
拼接原始字符串timestamp + 时间戳 + appId + appSecret
STEP 02
首次 MD5使用 UTF-8 编码计算摘要
STEP 03
二次 MD5首次摘要 + 当前时间戳
STEP 04
组装 JSONappId / timestamp / sign
STEP 05
Base64 编码生成请求头 signInfo
JAVA · SIGNATURE
String str = "timestamp" + timestamp + appId + appSecret;
String encryptStr1 = MD5.create().digestHex(str, "UTF-8");

String str2 = encryptStr1 + timestamp;
String encryptStr2 = MD5.create().digestHex(str2, "UTF-8");
JSON → BASE64
{
  "appId": "5qMxMTuAUfNMBmvOCor8YmZthp38PogTjDhUYy53flDdRf1Pmw",
  "timestamp": "17195571936575",
  "sign": "encryptStr2"
}

String signInfo = Base64.encode(json, "UTF-8");
02 · REQUEST

请求示例

ENDPOINT
https://ip:port/examine/api/color/add
CONTENT TYPE
application/x-www-form-urlencoded
application/json
请求头：signInfo: “signInfo（生成方式见本页签名方式章节）”
REQUEST BODY
{
  "colorName": "红色",
  "colorStatus": 0
}
RESPONSE BODY
{
  "code": 200,
  "data": true,
  "msg": "",
  "timestamp": ""
}
03 · RESPONSE

响应字段说明

字段名字段名称类型说明
code响应码Int200：成功，其他：失败
data响应详情String响应报文
msg错误信息String错误信息
timestamp时间戳String响应时间：2024-06-28 15:28:35
接入翼检通合作平台

请使用平台分配的 appId 与 secret 完成签名，并在测试环境验证后切换正式环境。