腾信国际客户API对接文档
    腾信国际客户API对接文档
    • 客户对接API
      • 创建订单
        POST
      • 获取面单
        POST
      • 查询轨迹
        POST

    OpenApi

    1.1 通信协议#

    本 API 文档中的所有接口均通过 HTTPS协议 进行通信。

    1.2 服务地址#

    正式环境:https://interface.txfba.com

    1.3 请求方式#

    本文档所以的接口均采用 POST 请求方式;字符集 UTF-8;
    POST 请求支持的 Content-Type 类型: application/json;
    所以的请求参数均区分大小写,请注意书写格式。

    1.4 公共参数#

    公共参数是用于标识用户和签名的参数,如非必要,在每个接口单独的文档中不再对这些参数进行详细说明,但每次请求均需要携带这些参数,才能正常发起请求。
    公共参数需要统一放到 HTTP Header 请求头部中,请求头参数如下表所示:
    参数名称类型必填描述
    apiAccountString是API KEY,可联系业务员进行申请
    timestampInteger是当前 UNIX 时间戳,可记录发起 API 请求的时间。例如 1681766460。注意:如果与服务器时间相差超过5分钟,会引起签名过期错误
    signString是签名:apiAccount + apiPasswd + timestamp三个参数进行拼接,然后MD5加密获取MD5值,详情见本文档1.5签名获取方式
    注:Unix 时间戳是从1970年1月1日(UTC/GMT的午夜)开始所经过的秒数,不考虑闰秒。位数为10位。

    1.5 签名sign获取方式#

    1.
    apiAccount、apiPasswd、timestamp三个参数按顺序拼接
    2.
    对拼接结果进行MD5加密获取到一个MD5值
    3.
    把获取到的MD5值进行转大写,获取到的最终结果就是sign签名
    Java版

    1.6 统一响应结果#

    参数类型描述
    codeint响应码,200为响应成功,其他为失败
    msgString响应失败原因
    dataObject响应结果
    下一页
    创建订单
    Built with