中国邮政新一代寄递平台国际业务运单轨迹接口规范

"中国邮政寄递平台的国际业务（出口）运单轨迹信息获取接口规范，版本1.0，旨在定义平台与外部系统间的数据同步接口，确保数据完整性和准确性，促进系统集成流程的优化。接口通过HTTP POST请求实现，使用JSON格式传输数据，并采用MD5签名验证安全。" 这篇文档详细介绍了中国邮政新一代寄递平台针对国际出口业务的运单轨迹信息获取接口。接口的主要目的是促进平台与外部系统（如XX系统）之间的数据交换，满足数据同步需求。文档由新一代寄递平台项目组在2019年发布，旨在明确各参与方的职责，确保数据在传输和处理中的完整性。 实现方式上，系统间的通信是通过HTTP POST请求进行的，请求内容的编码格式为"application/x-www-form-urlencoded;charset=UTF-8"。消息体被封装为一个参数（msgBody），消息头的每个属性也作为单独的参数。为了确保安全，接口采用了MD5签名验证机制，消息头添加"dataDigest"字段，对消息体内容（结合系统ID）进行MD5运算并转化为Base64字符串，以防止数据被篡改。 报文格式统一为JSON，这是一种轻量级的数据交换格式，基于ECMAScript的一个子集，具有跨语言性。消息头包括发送方标识（sendID）、非必填的省份代码（proviceNo）、消息类别（msgKind）、消息唯一序列号（serialNo）和发送日期时间（sendDate）等字段。所有这些字段都是为了追踪和验证数据的来源、类型以及传输的时间戳，确保数据的有效性和一致性。 在请求报文部分，文档特别指出了消息头的各项字段及其必要性，例如sendID是必须的，表示发送方的身份，而serialNo则确保每条消息在特定类别中的唯一性。此外，sendDate用于记录消息发送的具体时间，格式为"YYYYMMDDHHMMSS"。 这个接口规范详细定义了中国邮政如何通过标准的HTTP协议和安全机制，与外部系统交换关于国际出口业务运单的轨迹信息，确保了服务的稳定性和安全性。对于需要接入此接口的开发者来说，这份文档提供了全面的技术指导，包括接口的使用方法、数据格式和安全措施。