La API de Socios utiliza autenticación basada en JWT. Esta es independiente de la API de Cliente — necesitas una clave de API de Socios para acceder a estos endpoints.
URL base: https://api.ship.uniuni.com/partner
Paso 1: Obtener un token de acceso
Intercambia tu clave de API por un token de acceso JWT llamando al endpoint de autenticación.
Los tokens de acceso son válidos por 24 horas. Almacena el token y reutilízalo hasta que expire.
Solicitud
| Encabezado | Valor |
|---|
X-API-Key | Tu clave de API de Socios |
Respuesta
{
"success": true,
"message": "Get token successfully",
"data": {
"accessToken": "eyJhbGciOiJIUzI1NiIs..."
}
}
Respuestas de error
{
"success": false,
"message": "Missing API Key"
}
{
"success": false,
"message": "Error generating API token"
}
Ejemplo
curl -X GET https://api.ship.uniuni.com/partner/auth/token \
-H "X-API-Key: your_api_key_here"
Paso 2: Usar el token de acceso
Incluye el token JWT en el encabezado Authorization para todas las llamadas posteriores a la API.
Authorization: Bearer <accessToken>
Ejemplo
curl -X GET "https://api.ship.uniuni.com/partner/track?trackingId=UR12345678901234567" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Códigos de error de autenticación
| Código de error | Descripción |
|---|
MissingTokenError | No se proporcionó el encabezado Authorization |
ExpiredTokenError | El token de acceso JWT ha expirado — solicita uno nuevo |
InvalidTokenError | El token está malformado o la clave de API es inválida |
TokenPayloadError | No se pudo decodificar el payload del token |
Ejemplo de respuesta de error
{
"success": false,
"message": "Missing API Key"
}
