Autenticación

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

GET /auth/token

Encabezado	Valor
`X-API-Key`	Tu clave de API de Socios

Respuesta

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

Respuestas de error

Clave API faltante
Error al generar el token

{
  "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"
}

Primeros pasos

Endpoints de la API de Socios

Paso 1: Obtener un token de acceso

Solicitud

Respuesta

Respuestas de error

Ejemplo

Paso 2: Usar el token de acceso

Ejemplo

Códigos de error de autenticación

Ejemplo de respuesta de error

​Paso 1: Obtener un token de acceso

​Solicitud

​Respuesta

​Respuestas de error

​Ejemplo

​Paso 2: Usar el token de acceso

​Ejemplo

​Códigos de error de autenticación

​Ejemplo de respuesta de error

Paso 1: Obtener un token de acceso

Solicitud

Respuesta

Respuestas de error

Ejemplo

Paso 2: Usar el token de acceso

Ejemplo

Códigos de error de autenticación

Ejemplo de respuesta de error