跳转到主要内容
此页面由英文翻译而成。英文版为官方权威来源。如翻译内容有任何不一致之处，请以英文版为准。

​
支持

​
技术支持

如有集成问题、API 问题或故障排除需求，请联系 Flex Forward 团队： 电子邮件： [email protected] 报告问题时，请提供以下信息以帮助我们快速解决：
  • 标签 ID（如适用）
  • 请求时间戳（ISO 8601 格式）
  • 收到的 HTTP 状态码
  • 错误响应体（完整 JSON）
  • 环境（生产或开发）
  • 端点（例如 POST /labels）
请求关联头部（X-Request-Id）计划在未来版本中提供。一旦可用，请在问题报告中包含以加速解决。
对于影响生产环境的问题，请在电子邮件主题中包含 [PRODUCTION]，以便团队适当地安排优先级。

​
部署与账户设置

如需 API 访问申请、配送账户设置或物流商启用，请联系同一电子邮件地址。 部署流程：
1

申请账户启用

将您的使用场景和预期配送量以电子邮件发送给 Flex Forward 团队，以便我们启用您的账户并配置您的配送账户。
2

获取认证信息

账户启用后，请登录 Return Helper User Portal，并从 Settings → Signing Key and API Token 复制开发与生产环境的 API 密钥与 API 令牌。
3

在开发环境测试

使用开发环境在物流商沙盒服务上验证您的集成。
4

正式上线

测试完成后，切换至生产基础 URL 和生产认证信息。

​
常见问题

请登录 Return Helper User Portal，并从 Settings → Signing Key and API Token 复制您的 API 密钥与 API 令牌。若您的账户尚未启用 Flex Forward，请联系 [email protected]。
YunExpress 目前已启用于生产环境的配送，支持全球跨境电商物流。可根据物流路线需求和账户设置来启用额外的物流商。如需了解物流商的可用性，请联系团队。
是的。开发环境（https://sandbox.flexforwardship.com）连接至物流商的沙盒服务，可安全进行测试。详情请参阅环境。
使用 POST /labels 中的 idempotencyKey 字段。相同密钥和请求体会重放已保存结果，修改请求体则返回 409 IDEMPOTENCY_CONFLICT。详情请参阅幂等性与重试。
标签文件支持 PDF 和 PNG。创建时可将 label.format 设为 PDF 或 PNG，并在 GET /labels/{id} 的 labelFormat 查看小写格式。完整的响应模式请参阅 API 参考。
Webhook 目前不可用。请使用 GET /tracking/{id} 轮询追踪状态更新。如果您有需要推送通知的使用场景，请联系团队。
追踪检查点的时间戳（checkpointTime）以 UTC（ISO 8601 格式，Z 后缀）返回。