API
51Tracking提供API接口及相关功能，接口速率、类型、及调用步骤请跳转至相应的Api文档进行查看。强烈推荐您使用V4版本，支持了更多的字段信息，优化了报文结构，提供了UTC时间格式。V4版本不向下兼容，但您任可以使用V2以及V3版本。在不久的将来我们将会停用V2 V3版本，届时会通过邮件&短信进行告知。 请注意API的调用为一项付费功能，我们为新用户提供注册起为其7天的免费试用。试用期过后，升级您的账户即可继续使用该功能。
如何使用Webhook
【开发者中心】→【Webhook】 您需要提供一个允许公网访问的API接口地址，用于接收物流轨迹信息推送我们系统会默认一个单号物流轨迹推送给您进行接收测试当您保存webhook地址以及版本之后，会出现可以选择具体物流轨迹推送的节点一个账号只能有一个Webhook URL，保留3天内的推送记录
API调用步骤
1.创建单号：调用「添加物流单号」接口POST 2.获取结果调用「 获取查询结果」接口GET（最多一次请求，一次请求最多2000个单号）
获取API Key
进入51用户后台，选择「开发者中心」 → 「API Key调试」，复制你的API Key。 Tips：获取 API Key 之后，请妥善保管你的 API Key，不要将其分享到网站上，这可能导致 API Key 被他人使用而造成损失。
V3版本 Webhook 签名验证
为了确保消息的来源身份是 51tracking，你可以选择对 POST 数据的来源进行安全认证。 ( 不验证，直接解析 POST 的数据也可以 ) 安全认证的方法如下： 解析出 POST 数据中的 timestamp 和 signature 这两个参数。 使用你的 51tracking 用户邮箱(密钥) 和 timestamp (明文) 生成签名 signature, 与 POST 数据中的 signature 进行校验 ( 签名算法: PHP：SHA256、JAVA：HmacSHA256) 备注:使用附带的Jave和Php示例代码来验证51Tracking数据，当验证您自己的数据请替换SIGNATURE，TIMESTAMP 和 ACCOUNT。 Javaimport javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import java.security.InvalidKeyException; import java.security.NoSuchAlgorithmException; public class Main { public static void main(String[] args) throws NoSuchAlgorithmException, InvalidKeyException { String signature = \"0d90bb874fed0b056d8b3aa794529ebacd49932a0cea691629b63eaf2ca9d400\"; String timestamp = \"1653632765\"; String account = \"info@trackingmore.org\"; Mac sha256_HMAC = Mac.getInstance(\"HmacSHA256\"); SecretKeySpec secret_key = new SecretKeySpec(account.getBytes(), \"HmacSHA256\"); sha256_HMAC.init(secret_key); byte[] bytes = sha256_HMAC.doFinal(timestamp.getBytes()); StringBuilder new_signature = new StringBuilder(); for (byte item : bytes) { new_signature.append(Integer.toHexString((item & 0xFF) | 0x100).substring(1, 3)); } System.out.println(new_signature.toString()); System.out.println(new_signature.toString().equals(signature)); } } Php$signature = \'0d90bb874fed0b056d8b3aa794529ebacd49932a0cea691629b63eaf2ca9d400\'; $timestamp = \'1653632765\'; $account = \'info@trackingmore.org\'; $new_signature = hash_hmac(\'sha256\', $timestamp, $account); var_dump($signature == $new_signature , $new_signature); * V2与V3版本的签名是 邮箱+时间戳 的加密方式，如果您变更了您的账户邮箱，需要更改签名使用的邮箱。V4版本中使用的是 APIKey+时间戳 的加密方式，所以不存在此问题。
API在线调试
1.开始调试【开发者中心】→【API密匙】→【在线调试】 2.创建单号流程注：创建会消耗您的单号额度，创建后需等待一些时间查询物流轨迹，否则单号状态为查询中，无法获取到物流轨迹 第一步：需先选择 /v3/trackings/create 接口，创建运单号，如果您配置了 Webhooks，当获取到物流轨迹后，将会通知到您的系统 第二步：选择 /v3/trackings/get 接口，获取第一步添加运单号物流轨迹
