Fiabilité de l’API : erreurs et limites

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 :

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. Pour les erreurs propres à un endpoint, utilisez la référence API générée.

Démarrer

API

Webhooks

Référence OpenAPI

Fiabilité de l’API : erreurs et limites

Traitez la réponse

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

​Traitez la réponse

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

Traitez la réponse

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