首页 / 文档中心 / 平台接口 API / 接口说明

接口说明

平台接口 API · 第三方接入文档

获取渠道名称和秘钥

  1. 需要在 https://platform.xstrive.com/ 注册一个账号
  2. 把第一步注册的 邮箱账号 发送给工作人员获取接入渠道名称 channel 和 秘钥 secret
  3. 迅思维公共平台接口请求地址:http://third.platform.xstrive.com
    自建平台可本地访问:http://127.0.0.1/third/

签名规则 (token生成)

  1. 签名使用md5加密生成token参数进行传递校验
  2. 通过第一步获取的secret 进行加密串拼接
  3. 加密串按Url参数词典序(如有大小写并列,大写在前)进行排序通过&符号进行拼接
    参数排序JS代码示例:keys = [key1,key2,...,secret,t]; keys = keys.sort();
    其它语言请自行查阅API
    比如:
    http://third.platform.xstrive.com/product/online?channel=common&productId=test144&token=c054ddeb010a3c44427bd3a345aba1ee&t=1577587794
    加密串(除token外的所有参数):
    sign = channel=common&productId=test144&secret=df138a4ffa97d1f8fe41646670ccc842&t=1577587794
    加密后: token = md5(sign) = c054ddeb010a3c44427bd3a345aba1ee

加密后的串和请求的token一致签名验证通过

请求 content-type 设置

header['content-type'] 为 application/x-www-form-urlencoded

请求固定携带参数

参数名 描述 类型 必传 附加说明
channel 渠道名 String Y
token 签名串 String Y
t 当前时间戳 Number Y 单位:秒

失败统一返回JSON格式

{
    "code": Number, // 错误码
    "msg": String   // 错误信息
}

示例:

{
    "code":401,
    "msg":"非法请求"
}
这份文档没解决你的问题?联系我们,技术工程师直接对接。

询价咨询

填写这几项,我们 1 个工作日内回传报价与方案

点「生成询价邮件」会打开你的邮件客户端,正文已自动填好;电脑没配邮件客户端,就点「复制内容」粘到网页邮箱发送,收件人 sunshiyang@xstrive.com。