Skip to main content
UniUni平台客户端API允许您通过编程方式创建货件、购买面单、管理批次、追踪配送以及接收Webhook通知。

环境

我们提供沙盒生产两个环境。请先在沙盒环境中测试您的集成,再上线使用。 所有请求仅支持HTTPS。

身份验证

每个请求必须在Authorization头中包含您的API访问令牌
请参阅创建访问令牌了解生成和管理令牌的详细步骤。

请求与响应格式

  • 所有请求和响应使用JSON格式。
  • POST请求体使用Content-Type: application/json; charset=utf-8
  • 所有对象键使用驼峰命名法(camelCase)
  • 响应HTTP状态码始终为200(有效载荷)。无效载荷返回HTTP 422
每个响应遵循以下结构:

分页

列表端点支持通过查询参数进行分页:

沙盒测试

您可以使用沙盒基础URL自由测试集成。不会产生任何费用。沙盒数据是隔离的,重置不会影响生产环境。 要在沙盒中添加测试额度,请使用测试信用卡号4242 4242 4242 4242,任意有效期和CVC。

错误处理

422 无法处理的内容

当必需参数缺失或类型错误时返回:

身份验证错误

错误代码