跳转到主要内容
合作伙伴API使用基于JWT的身份验证。这与客户端API是分开的——您需要合作伙伴API密钥才能访问这些端点。 基础URL: https://api.ship.uniuni.com/partner

第1步:获取访问令牌

通过调用身份验证端点,用您的API密钥换取JWT访问令牌。
访问令牌有效期为24小时。请存储令牌并重复使用,直到过期。

请求

GET /auth/token
请求头
X-API-Key您的合作伙伴API密钥

响应

{
  "success": true,
  "message": "Get token successfully",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs..."
  }
}

错误响应

{
  "success": false,
  "message": "Missing API Key"
}

示例

curl -X GET https://api.ship.uniuni.com/partner/auth/token \
  -H "X-API-Key: your_api_key_here"

第2步:使用访问令牌

在所有后续API调用中,在Authorization请求头中包含JWT令牌。
Authorization: Bearer <accessToken>

示例

curl -X GET "https://api.ship.uniuni.com/partner/track?trackingId=UR12345678901234567" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

身份验证错误代码

错误代码描述
MissingTokenError未提供Authorization请求头
ExpiredTokenErrorJWT访问令牌已过期——请重新获取
InvalidTokenError令牌格式错误或API密钥无效
TokenPayloadError令牌载荷无法解码

错误响应示例

{
  "success": false,
  "message": "Missing API Key"
}