快速开始

从注册到追踪第一个包裹，只需 10 分钟。

本指南将引导你把第一批运单导入 Track123，快速开始追踪。

完成本指南后，你的运单将出现在控制台中，可以实时监控和管理。

创建账号

前往 track123.com 注册免费账号，每个账号有100个免费额度。

注册完成后，你将进入首页，页面上的新手引导清单会带你完成后续步骤。

获取 API Token (仅开发者)

如果你不需要通过 API 接入，请跳过此步骤，直接进入第 3 步。

你的 API Token 显示在首页右侧的开发者面板中。

请妥善保管你的 API Token。 不要将其暴露在客户端代码或公开代码仓库中。如果 Token 泄露，请立即点击首页的重置按钮生成新 Token。

导入运单

Track123 支持三种导入方式，选择适合你工作流程的方式即可。

通过 API 导入 (开发者)

适合自动化工作流。在订单发货时，由系统自动将运单号发送到 Track123，无需人工操作。

从首页复制你的 API Token
发送 POST 请求创建运单：

curl --request POST \
     --url https://api.track123.com/gateway/open-api/tk/v2.1/track/import \
     --header 'Track123-Api-Secret: 952a057cafde432xxxxe594e464de0ac' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
[
  {
    "trackNo": "LV209031969CN"
  }
]
'

运单将立即出现在你的运单列表中

通过表格导入

适合批量导入，一次最多可上传 50,000 个运单。

在左侧导航栏进入运单页面
点击导入 → 通过表格导入
点击下载模板获取正确的文件格式
在模板中填写快递单号和快递简码
保存文件并上传

Track123 将处理文件并导入所有有效行。

注意： 缺少快递单号/快递简码或格式有误的行将被跳过，上传完成后会显示错误报告。

→ 表格导入完整指南

手动添加

直接在控制台添加运单，无需文件或代码，一次最多输入 100 个运单号。

在左侧导航栏进入运单页面
点击右上角添加运单
从下拉菜单选择承运商，或留空由系统自动识别
在文本框中输入运单号，每行一个（最多 100 个）
点击确认

运单将立即出现在列表中，状态显示为待同步。

查看追踪结果

Track123 提供三种方式查看追踪结果，选择适合你的方式。

通过 API 获取 (开发者)

通过调用 GET 接口，以编程方式查询追踪结果。

curl --request POST \
     --url https://api.track123.com/gateway/open-api/tk/v2.1/track/query \
     --header 'Track123-Api-Secret: 952a057cafdexxxxxxxx594e464de0ac' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "trackNoInfos": [
    {
      "trackNo": "92612903033646543475000000"
    }
  ]
}
'

返回结果包含当前状态、所有追踪节点、承运商信息和时间戳。

→ 完整 API 参考文档

通过 Webhook 推送 (开发者)

配置 Webhook，在运单状态变更时由 Track123 主动推送更新到你的服务器，无需轮询。

在左侧导航栏进入开发者 → Webhook
点击添加 Webhook
填写你的接收地址，选择需要监听的事件类型
点击保存

→ Webhook 配置完整指南

在控制台查看

无需代码，直接在运单页面监控所有包裹状态。

在左侧导航栏进入运单页面
通过顶部状态标签筛选运单
点击任意运单查看完整的追踪时间线和节点详情

下一页核心概念

最后更新于 1个月前