开放 API
所有接口使用 HTTPS，请求头带 Authorization: Bearer moda_live_…。密钥在登录后的 API 页面创建，只显示一次。
创建面单和扣款请带 Idempotency-Key。同一把钥匙的重复请求返回第一次的结果，不会再次扣款。钥匙不同但内容不同则视为新订单。
金额字段单位是美分。报价按账户价格等级计算，不返回承运商成本。
获取报价
POST /api/v1/quote
{ "fromZip": "91761", "to": { "zip": "10001" }, "weight": 2, "weightUnit": "lb", "length": 12, "width": 10, "height": 8, "dimUnit": "in", "residential": false }购买面单
POST /api/v1/labels
{ "fromZip": "91761", "to": { "name": "Jane", "phone": "2125550148", "street1": "120 Broadway", "city": "New York", "state": "NY", "zip": "10005" }, "weight": 2, "weightUnit": "lb", "length": 12, "width": 8, "height": 4, "carrierCode": "usps", "serviceCode": "ground_advantage" }取消并按规则退款
POST /api/v1/labels/{id}/void
无请求体
查询订单
GET /api/v1/orders/{id}
轨迹
GET /api/v1/track/{trackingNumber}
余额
GET /api/v1/balance
错误
失败时 HTTP 状态非 2xx，正文为 { "error": { "code", "message" } }。常见 code：UNAUTHENTICATED、INSUFFICIENT_BALANCE、EMAIL_UNVERIFIED、RATE_UNAVAILABLE、IDEMPOTENCY_CONFLICT。