合作伙伴API使用基于JWT的身份验证。这与客户端API是分开的——您需要合作伙伴API密钥才能访问这些端点。
基础URL: https://api.ship.uniuni.com/partner
第1步:获取访问令牌
通过调用身份验证端点,用您的API密钥换取JWT访问令牌。
访问令牌有效期为24小时。请存储令牌并重复使用,直到过期。
{
"success": true,
"message": "Get token successfully",
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiIs..."
}
}
错误响应
{
"success": false,
"message": "Missing API Key"
}
{
"success": false,
"message": "Error generating API token"
}
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请求头 |
ExpiredTokenError | JWT访问令牌已过期——请重新获取 |
InvalidTokenError | 令牌格式错误或API密钥无效 |
TokenPayloadError | 令牌载荷无法解码 |
错误响应示例
{
"success": false,
"message": "Missing API Key"
}