常见问题
没有找到答案？联系我们，通常 24 小时内回复。
接口是免费的吗？
是。注册后每月有 10,000 次免费查询额度，个人开发者无需企业认证。超出部分可联系我们按需开通。
不注册能先试一下吗？
可以。首页的在线演示使用公开测试密钥，可直接发送真实请求查看返回结构（按 IP 每天限 20 次）。确认符合需求后再注册即可。
需要企业认证或营业执照吗？
不需要。邮箱注册即可生成密钥，个人开发者可直接使用。
什么是 COURIER_PREPARING 错误码？
部分快递公司调用时会返回 COURIER_PREPARING，表示该公司当前暂时无法返回轨迹。这类请求不消耗额度。各公司支持状态以接口文档的编码表为准。
目前哪些公司可以实际查询？
支持菜鸟国际（跨境包裹，如 AliExpress 订单）以及顺丰、中通、圆通、申通、韵达、京东、极兔、邮政EMS、德邦等国内主流公司。完整编码表与各公司支持状态见接口文档。
返回的状态码是统一的吗？
是。各家快递公司的原始状态被归一为 12 个标准状态码（如 IN_TRANSIT 运输中、DELIVERED 已签收），跨公司口径一致，方便统一处理。
一次可以查多少个运单号？
单次请求最多 10 个运单号。批量请求按条计额度，某一条失败不影响其他条目的返回。
NOT_FOUND 会扣额度吗？
会。NOT_FOUND 表示接口调用已完成但该运单暂无物流信息，调用本身已发生所以计入额度。参数错误、格式错误以及返回 COURIER_PREPARING 的请求都不计额度。
Secret Key 丢了怎么办？
Secret Key 只在生成时展示一次。丢失后请在控制台吊销旧密钥并重新生成，旧密钥立即失效。
调用频率有什么限制？
免费版限制为每分钟 20 次、每小时 300 次、每天 1,000 次、每月 10,000 次。超出会返回 429 状态码。