Erreurs et quotas

Les erreurs utilisent Problem Details. Conservez X-Request-ID pour toute demande au support.

Statuts HTTP

Statut	Code	Signification	V1 actuelle
`400`	`INVALID_REQUEST`	Paramètre invalide	Émis
`401`	`MISSING_API_KEY / INVALID_API_KEY`	Clé absente, invalide ou révoquée	Émis
`403`	`FORBIDDEN`	Réservé aux futures règles d’autorisation	Réservé
`404`	`RESOURCE_NOT_FOUND / ROUTE_NOT_FOUND`	Ressource ou route inconnue	Émis
`405`	`METHOD_NOT_ALLOWED`	Réservé aux opérations non autorisées	Réservé
`409`	`CONFLICT`	Réservé aux futures opérations d’écriture ; jamais émis par la V1 en lecture seule	Réservé
`415`	`UNSUPPORTED_MEDIA_TYPE`	Réservé aux futures requêtes avec corps	Réservé
`422`	`UNPROCESSABLE_CONTENT`	Réservé aux futures validations métier	Réservé
`429`	`QUOTA_EXHAUSTED / TOO_MANY_REQUESTS`	Quota minute, mensuel ou limite globale atteint	Émis
`500`	`INTERNAL_ERROR`	Erreur interne avec request ID	Émis
`502`	`UPSTREAM_ERROR`	Réservé aux futures dépendances amont	Réservé
`503`	`SERVICE_UNAVAILABLE`	Réservé aux indisponibilités temporaires de l’API	Réservé

Format uniforme

Toutes les erreurs effectivement émises utilisent application/problem+json. Le champ code est stable pour l’automatisation ; title et detail restent destinés à la lecture humaine.

application/problem+json400

{
  "type": "https://fenua-api.pacificknowledge.dev/problems/invalid-request",
  "code": "INVALID_REQUEST",
  "title": "Invalid request",
  "status": 400,
  "detail": "One or more request parameters are invalid.",
  "instance": "/api/v1/places/search?q=",
  "requestId": "req_01HZZ2FENUA",
  "errors": [
    {
      "code": "INVALID_PARAMETER",
      "message": "must NOT have fewer than 1 characters",
      "path": "/q"
    }
  ]
}

Headers de quota

RateLimit-Limit: 60
RateLimit-Remaining: 42
RateLimit-Reset: 1787900400
Retry-After: 18
X-Request-ID: req_01HZZ2FENUA
X-Data-Version: 2026.2

Après une réponse 429

Attendez la durée indiquée par Retry-After avant de réessayer. Les erreurs 5xx ne sont pas décomptées des quotas minute et mensuel.