> ## Documentation Index
> Fetch the complete documentation index at: https://sandbox.it-centrex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Errors

> Comprendre les codes d'erreur retournés par l'API GIMgar Sud et comment les gérer.

Chaque API GIMgar Sud retourne un code de statut HTTP standard accompagné d'une cause précise. Utilisez le code de statut pour déterminer la catégorie du problème, puis reportez-vous à la section **Codes d'erreur** de la page de l'endpoint concerné pour la cause exacte.

## Codes de statut HTTP

> **400 - Bad Request**
>
> Un paramètre requis est manquant, ou une donnée fournie est incorrecte (format invalide, valeur hors énumération, etc.). Corrigez la requête avant de réessayer.

> **401 - Unauthorized**
>
> Le token Bearer est manquant, invalide ou expiré. Générez un nouveau token via [Authentication](https://sandbox.it-centrex.com/getting-started/authentication.md) et réessayez.

> **404 - Not Found**
>
> L'entité demandée (usager, instrument de paiement, contributeur, MMP, service, opération, pays, terminal...) est introuvable. Vérifiez l'identifiant utilisé.

> **406 - Not Acceptable**
>
> L'entité existe mais n'est pas dans le statut attendu pour cette action. Par exemple verrouiller un instrument de paiement déjà inactif, ou désenrôler un instrument déjà désenrôlé.

> **409 - Conflict**
>
> L'action entre en conflit avec un état existant. Par exemple ajouter un bénéficiaire ou une MMP déjà marqués comme favoris.

> **500 - Internal Server Error**
>
> Problème côté serveur GIMgar Sud. Réessayez après un court délai ; contactez le support si l'erreur persiste.

> [!NOTE]
>
> L'API d'authentification (`POST /api/v1/auth/token`) ne retourne que les codes `400` et `500`, puisqu'aucun token n'est requis pour l'obtenir.

## Stratégie de nouvel essai

**Ne réessayez pas** une erreur `4xx` sans modifier la requête. Le problème vient de la requête elle-même et le même appel échouera à nouveau.

**Réessayez** une erreur `500` après un court délai. Si le problème persiste après plusieurs tentatives, contactez le support GIM-UEMOA.

## Étapes suivantes

> **[Authentication](https://sandbox.it-centrex.com/getting-started/authentication.md)**
>
> Générez et utilisez votre token d'accès.

> **[Tester votre intégration](https://sandbox.it-centrex.com/getting-started/testing.md)**
>
> Utilisez le sandbox interactif pour observer ces erreurs en conditions réelles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.