商务版本说明
产品更新的版本说明和更新日志
价格起价 US$10

Authorization: Bearer <your_key>。https://api.trackpoint.example/v1GET /shipments/{tracking_number}
返回单个包裹的当前状态和事件记录。
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| tracking_number | path | 是 | 承运商运单号,8–30 个字符 |
| lang | query | 否 | 状态文本语言:en、de、fr。默认 en |
请求示例
curl https://api.trackpoint.example/v1/shipments/JD014600006281 \
-H "Authorization: Bearer sk_test_51x..."
响应示例(200)
{
"tracking_number": "JD014600006281",
"status": "in_transit",
"estimated_delivery": "2026-11-19",
"events": [
{"time": "2026-11-16T08:42:00Z", "location": "Leipzig hub", "status": "in_transit"}
]
}
| 代码 | 含义 | 处理方法 |
|---|---|---|
| 401 | 缺少 API 密钥或密钥错误 | 检查 Authorization 请求头 |
| 404 | 找不到运单号 | 承运商登记新包裹最多可能需要 2 小时 |
| 429 | 每分钟请求超过 100 次 | 按 Retry-After 请求头中的时间等待 |
全部 14 个接口的 Markdown 文档,可直接放到客户的文档网站;另附一份清单,列出 API 实际行为与说明不符的 3 处,已发给开发团队。
客户: Trackpoint,一家初创公司,其 REST API 让网店展示包裹状态;开发团队发来了 14 个接口的简短说明和一组示例请求 任务: 一份快速入门和接口参考文档,让开发者 15 分钟就能上手;以下为节选
客户及所有信息均为虚构。
开发人员几分钟内就会通过文档来评判一个API:如果身份验证或第一次请求不成功,他们就会离开。我们根据您的端点描述、OpenAPI文件或代码示例编写API参考和指南:身份验证、基础URL、每个端点的参数、请求和响应示例、错误代码、速率限制和分页。快速入门用几个步骤展示第一次成功调用。
以文本形式粘贴的端点描述或OpenAPI、Postman文件、身份验证详情、请求和响应示例、错误代码,以及您的API用户是谁。
我们会询问您:
您在下单时付款,但款项仅在您验收后才会结算。
能,请将YAML或JSON粘贴到需求说明中。我们会将其中的描述转化为易读的参考页面,并补充您指出的空缺。
我们不调用您的API。示例根据您的请求和响应样本构建,请在发布前运行一遍。
会,只要您发送方法签名和使用示例。每个SDK都计入套餐的工作量。
没有找到答案?