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

# Fiabilité de l’API : erreurs et limites

> Interprétez les erreurs API, les en-têtes de limite, Retry-After et X-Trace-Id dans une intégration Immoteur

Traitez les réponses API selon leur code de statut et leur corps problem details. Ne traitez pas une réponse en erreur comme un résultat réussi.

## Traitez la réponse

| Résultat                      | Action                                                                                                   |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| `2xx`                         | Traitez le corps de réponse documenté                                                                    |
| `401`                         | Vérifiez le token API et la configuration de l’authentification Bearer                                   |
| `403`, `404` ou `422`         | Lisez la réponse `application/problem+json` et corrigez l’accès, l’identifiant ou les données de requête |
| `429`                         | Attendez `Retry-After` avant d’envoyer la requête suivante, puis consultez les en-têtes de limite        |
| Investigation avec le support | Conservez `X-Trace-Id` avec le contexte de la requête                                                    |

## Lisez les en-têtes de limite et de diagnostic

Les valeurs des en-têtes de limite sont ordonnées par seconde, minute, puis jour. Les limites dépendent de votre abonnement : lisez la réponse plutôt que de coder en dur des valeurs d’exemple.

| En-tête               | Comportement                                                                      | Action du client                                                                       |
| --------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `RateLimit-Policy`    | Décrit les fenêtres actives, par exemple une limite et la durée de sa fenêtre     | Utilisez-le pour interpréter les valeurs correspondantes des autres en-têtes de limite |
| `RateLimit-Limit`     | Nombre maximal de requêtes dans chaque fenêtre active par seconde, minute et jour | Planifiez le débit selon la réponse, pas selon une valeur fixe de documentation        |
| `RateLimit-Remaining` | Nombre de requêtes encore disponibles dans chaque fenêtre                         | Ralentissez avant que la fenêtre avec le moins de requêtes restantes n’atteigne zéro   |
| `RateLimit-Reset`     | Nombre de secondes avant la réinitialisation de chaque fenêtre courante           | Utilisez-le pour savoir quand de la capacité sera de nouveau disponible                |
| `Retry-After`         | Nombre de secondes à attendre après `429 Too Many Requests`                       | N’envoyez pas la requête suivante avant la fin de ce délai                             |
| `X-Trace-Id`          | Identifiant de corrélation ajouté aux réponses problem details                    | Conservez-le avec le contexte de la requête lorsque vous contactez le support Immoteur |

Utilisez `curl --include` pendant l’intégration pour consulter les en-têtes et le corps de réponse :

```bash theme={null}
curl --include --show-error --silent \
  'https://api.immoteur.com/public/v1/auth' \
  -H "Authorization: Bearer $IMMOTEUR_TOKEN"
```

Pour les tokens et les data access, consultez [Tokens API et accès aux données](./configuration). Pour les erreurs propres à un endpoint, utilisez la référence API générée.