51Tracking 每月可通过API免费查询200单国际运单轨迹，支持webhook主动更新最新轨迹信息。
51Tracking帮助电子商务企业高效地更新和管理他们的货物。
您可以使用51Tracking的查询API无缝管理物流轨迹，并从管理门户使用51Tracking的购买服务。或者您可以通过API和webhook存储物流轨迹数据，并自行定制购买服务。
本快速入门指南引导你完成 3 种常见方案，让你了解如何使用 51Tracking 来创建和管理物流轨迹。
- 什么是物流追踪？
追踪是指与货件相关的信息，包括快递员的姓名、快递员提供的追踪号码和物流节点。
对于包含“跟踪”的所有字段，请参阅跟踪对象。
2. 获取 API 密钥
51Tracking 通过在标头中添加Tracking-Api-Key来验证用户的请求。
要获取您的 API 密钥，请注册51Tracking账户，注册成功后自动生成属于您的API Key，同时也可在账户后台生成新的API Key。
3. API 端点
https://api.51Tracking.***/v4
所有端点只能通过HTTPS访问，并位于api.51Tracking.***
4. 常见场景
场景 1. 创建物流单号进行查询
使用 POST API https://api.51Tracking.***/v4/trackings/create
API document
curl --location --request POST ‘https://api.51Tracking.***/v4/trackings/create’
–header ‘Tracking-Api-Key: your 51Tracking api key’
–header ‘Content-Type: application/json’
–data’{
“tracking_number”: “9261290312833844954982”,
“courier_code”: “usps”
}’
创建物流单号追踪事件时，我们建议您为我们提供快递单号（必填）、物流商简码（必填）和其他快递信息（选填）。
以下是提供快递员信息的 2 种方法
1 . 如果您知道具体的快递公司，请填写该字段（例如，ups-mi） courier_code
2 . 对于某些物流商，必须填写一些额外的字段进行查询追踪，否则您的跟踪将无法创建。
请查看我们的特殊物流商字段 以获取必填字段。
场景 2.更新物流单号信息
使用 API https://api.51Tracking.***/v4/trackings/update/id
如果您要更新订单信息和物流单号添加额外信息，可以使用该API接口进行更新。
场景 3.获取有关物流轨迹的更新
1 . 通过 Webhook
51Tracking可以通过Webhook向您推送每次物流轨迹更新的通知。有了它，您可以存储所有物流轨迹详细信息并构建自己的查询页面。
要设置您的Webhook，请前往后台-开发者中心以填写您的Webhook URL 并保存。
Webhook 响应示例
{
“code”: 200,
“message”: Su***ess,
“data”: {
“id”: “978dbf23f77a6db1123d2b0d37be271e”,
“tracking_number”: “9261290312833844954982”,
“courier_code”: “USPS”,
“order_number”: “1234”,
“order_id”: “1234”,
“order_date”: “2022-08-17T20:10:45+00:00”,
“created_at”: “2022-08-18T19:08:49+00:00”,
“update_at”: “2022-09-21T19:02:21+00:00”,
“delivery_status”: “delivered”,
“archived”: “tracking”,
“updating”: true,
“destination_country”: “HK”,
“origin_country”: “US”,
“tracking_postal_code”: null,
“tracking_ship_date”: null,
“tracking_destination_country”: null,
“tracking_courier_a***ount”: null,
“tracking_key”: null,
“tracking_origin_country”: null,
“customer_name”: “Joe”,
“customer_email”: “example@mail.***”,
“customer_sms”: “+11234567890”,
“title”: “Product_1234”,
“logistics_channel”: null,
“note”: “VIP client”,
“service_code”: “USPS Tracking Plus”,
“weight”: null,
“substatus”: “delivered001”,
“status_info”: null,
“previously”: null,
“destination_track_number”: null,
“exchange_number”: null,
“signed_by”: null,
“scheduled_delivery_date”: null,
“scheduled_address”: null,
“latest_event”: “Delivered, In/At Mailbox”,
“latest_checkpoint_time”: “2022-09-06T12:46:00”,
“transit_time”: 16,
“stay_time”: 16,
“origin_info”: {
“courier_code”: “usps”,
“courier_phone”: null,
“weblink”: “https://www.usps.***/”,
“reference_number”: null,
“pickup_date”: “2022-08-21T04:26:00”,
“departed_airport_date”: null,
“arrived_abroad_date”: null,
“customs_received_date”: null,
“arrived_destination_date”: “2022-09-06T12:46:00”,
“trackinfo”: [
{
“checkpoint_date”: “2022-09-06T12:46:00”,
“tracking_detail”: “Delivered, In/At Mailbox”,
“location”: “ALBUQUERQUE,NM,87105”,
“checkpoint_delivery_status”: “delivered”,
“checkpoint_delivery_substatus”: “delivered001”
},
…
]
},
“destination_info”: {
}
}
}
2 . 通过 API 获取物流轨迹
若要获取最新的物流轨迹节点，请使用 GET API 接口 https://api.51Tracking.***/v4/trackings/get/tracking_numbers=9261290312833844954982
注意: GET API 每秒限制 2 个请求，如果超出，将显示错误。
请求示例
curl --location --request GET ‘https://api.51tracking.***/v4/trackings/get?tracking_numbers=9261290312833844954982’
–header ‘Tracking-Api-Key: your 51Tracking api key’
–header ‘Content-Type: application/json’
响应示例
{
“meta”: {
“code”: 200,
“message”: “Request response is su***essful”
},
“data”: {
“su***ess”: [
{
“id”: “string”,
“tracking_number”: “string”,
“courier_code”: “string”,
“order_number”: “string”,
“shipping_date”: “string”,
“order_date”: “string”,
“create_at”: “string”,
“update_at”: “string”,
“delivery_status”: “string”,
“archived”: “tracking”,
“updating”: “true”,
“destination_country”: “string”,
“destination_state”: “string”,
“destination_city”: “string”,
“origin_country”: “string”,
“origin_state”: “string”,
