中通开放平台快递物流查询API对接流程

中通开放平台快递物流查询API对接流程

中通开放平台（以下简称“平台”）是提供中通大客户一站式接入服务的平台，提供各项API的接入服务，供客户、第三方软件供应商或第三方服务商与中通进行系统对接，连通与中通系统之间的信息流，实现整体物流数据的信息化，为合作伙伴提供极致的服务体验。

本篇博客将详细介绍该API的对接流程及相关技术细节，旨在帮助开发者快速完成接入工作，提升业务效率。

---

API简介

物流查询API

中通开放平台提供标准化的API接口，旨在为客户和平台实现高效的数据交互。通过物流查询服务，用户可轻松获取快件的实时物流信息，优化自身业务流程。

• 核心功能：
  • 物流轨迹查询：通过物流单号获取快件的详细轨迹信息。

---

对接流程

1. 注册用户

首先，需要在中通开放平台完成注册。注册链接

---

2. 提交资质认证

注册完成后，需“进入控制台，在概览页点击“立即认证”，选择“企业认证”。

---

3. 创建应用

进入控制台-业务对接-开发者对接页面，点击“新建应用”。每个应用对应您需要接入一个自研软件系统，平台将为每个应用分配独立的AppKey和AppSecret。

• 配置信息
  
• 完成创建
  

---

4. 添加服务

完成应用创建后，进入应用详情，点击“添加服务”后选择需要添加的能力或解决方案或API。

联调测试

按照API文档完成联调测试，如果过程中遇到问题，可以点击页面右下角“客服”按钮获取技术支持。

---

5. 发布上线

完成联调测试后，在应用详情页面，点击“发布上线”，即可提交发布上线申请。

---

签名机制详解

中通API采用签名认证机制，旨在确保接口调用安全。以下是签名的生成规则及代码示例。

签名生成
生成方式(支持平台标准签名、自定义签名)

• （1）平台标准签名：
  待签名字符串=请求body+appSecret
  appSecret请在开放平台登录后查看
  x-datadigest=base64(md5(待签名字符串))

• （2）用户自定义签名：支持自助选择“是否使用时间戳（毫秒）”、“md5或sha256”、“是否使用base64”进行配置使用；具体查看下方生成步骤

生成步骤

• 第一步-拼接
  无时间戳：业务参数body+appSecret，此时生成的字符串为待签名字符串。
  有时间戳：时间戳(毫秒)+业务参数body+appSecret，此时生成的字符串为待签名字符串。

• 第二步-生成签名
  算法见左侧菜单-多种语言示例
  以下是标准签名示例：
  假设有以下body

{
   
    "pageNo1": 33,
    "pageSize2": 23,
    "data": "test"
}

假设appSecret为

6fecf57d0f3e1c2100eac4810aa90b54

那么拼接成的待签名字符串为

{
   "pageNo1":33,"pageSize2":23,"data":"test"}6fecf57d0f3e1c2100eac4810aa90b54

• java案例
  git地址

package com.zto.zop;

import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;

public class ZopClient {
   
    private final ZopProperties properties;

    public ZopClient(ZopProperties properties) {
   
        this.properties = properties;
    }

    public ZopClient(String appKey, String appSecret) {
   
        this.properties = new ZopProperties(appKey, appSecret);
    }

    public String execute(ZopPublicRequest request) throws I