Authentification

L’API Partenaire utilise une authentification basée sur JWT. Celle-ci est distincte de l’API Client — vous avez besoin d’une clé API Partenaire pour accéder à ces points de terminaison. URL de base : https://api.ship.uniuni.com/partner

Étape 1 : Obtenir un jeton d’accès

Échangez votre clé API contre un jeton d’accès JWT en appelant le point de terminaison d’authentification.

Les jetons d’accès sont valides pendant 24 heures. Conservez le jeton et réutilisez-le jusqu’à son expiration.

Requête

GET /auth/token

En-tête	Valeur
`X-API-Key`	Votre clé API Partenaire

Réponse

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

Réponses d’erreur

Clé API manquante
Erreur de génération du jeton

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

{
  "success": false,
  "message": "Error generating API token"
}

Exemple

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

Étape 2 : Utiliser le jeton d’accès

Incluez le jeton JWT dans l’en-tête Authorization pour tous les appels API suivants.

Authorization: Bearer <accessToken>

Exemple

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

Codes d’erreur d’authentification

Code d’erreur	Description
`MissingTokenError`	Aucun en-tête `Authorization` fourni
`ExpiredTokenError`	Le jeton d’accès JWT a expiré — demandez-en un nouveau
`InvalidTokenError`	Le jeton est malformé ou la clé API est invalide
`TokenPayloadError`	Le contenu du jeton n’a pas pu être décodé

Exemple de réponse d’erreur

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

Pour commencer

Endpoints de l'API Partenaire

Étape 1 : Obtenir un jeton d’accès

Requête

Réponse

Réponses d’erreur

Exemple

Étape 2 : Utiliser le jeton d’accès

Exemple

Codes d’erreur d’authentification

Exemple de réponse d’erreur

​Étape 1 : Obtenir un jeton d’accès

​Requête

​Réponse

​Réponses d’erreur

​Exemple

​Étape 2 : Utiliser le jeton d’accès

​Exemple

​Codes d’erreur d’authentification

​Exemple de réponse d’erreur

Étape 1 : Obtenir un jeton d’accès

Requête

Réponse

Réponses d’erreur

Exemple

Étape 2 : Utiliser le jeton d’accès

Exemple

Codes d’erreur d’authentification

Exemple de réponse d’erreur