Erreurs

Une seule enveloppe partout : une phrase, un code, un ID de demande.

{
  "error": "The request body has problems.",
  "code": "VALIDATION_FAILED",
  "requestId": "a36bda957b8a7631-YVR",
  "docs_url": "https://docs.taxpio.com/errors#validation-failed",
  "problems": [{ "field": "inputs.taxableTotalProfitsPence", "message": "taxableTotalProfitsPence must be a whole number of at least 0." }]
}

Branchez-vous sur code, affichez error à une personne, journalisez requestId. Les échecs de validation énumèrent chaque problème avec le champ qui le porte. Un code nommé par la route est conservé; sinon, le code est celui du statut.

Code	Statut	Signification
`BAD_REQUEST`	400	Comme l'indique le statut.
`UNAUTHENTICATED`	401	Comme l'indique le statut.
`PAYMENT_REQUIRED`	402	Comme l'indique le statut.
`FORBIDDEN`	403	Comme l'indique le statut.
`NOT_FOUND`	404	Aucune ressource de ce type dans cet environnement.
`METHOD_NOT_ALLOWED`	405	Comme l'indique le statut.
`NOT_ACCEPTABLE`	406	Comme l'indique le statut.
`REQUEST_TIMEOUT`	408	Comme l'indique le statut.
`CONFLICT`	409	La demande entre en conflit avec l'état actuel (le message indique comment).
`GONE`	410	Comme l'indique le statut.
`PAYLOAD_TOO_LARGE`	413	Le corps dépasse la limite.
`UNSUPPORTED_MEDIA_TYPE`	415	Envoyez application/json.
`VALIDATION_FAILED`	422	Un ou plusieurs champs sont erronés; problems les énumère.
`LOCKED`	423	Comme l'indique le statut.
`PRECONDITION_REQUIRED`	428	Comme l'indique le statut.
`RATE_LIMITED`	429	Limite par minute dépassée; retry-after indique quand réessayer.
`INTERNAL`	500	Un problème est survenu de notre côté; indiquez l'ID de la demande.
`NOT_IMPLEMENTED`	501	Comme l'indique le statut.
`UNAVAILABLE`	503	Comme l'indique le statut.
`TIMEOUT`	504	Comme l'indique le statut.
`ORIGIN_REQUIRED`	403	Une modification par navigateur venant d'une autre origine (routes du produit seulement).
`PASSKEY_REQUIRED`	403	Comme l'indique le statut.
`PASSKEY_ENROLLMENT_REQUIRED`	428	Comme l'indique le statut.
`RECENT_MFA_REQUIRED`	428	Comme l'indique le statut.
`RECENT_AUTHENTICATION_REQUIRED`	403	Comme l'indique le statut.
`ACCOUNT_PASSWORD_REQUIRED`	428	Comme l'indique le statut.
`EMAIL_VERIFICATION_REQUIRED`	403	Comme l'indique le statut.
`VERIFICATION_DELIVERY_FAILED`	503	Comme l'indique le statut.
`RESOURCE_ROUTE_UNAVAILABLE`	503	Comme l'indique le statut.
`MALWARE_DETECTED`	422	Comme l'indique le statut.
`NONDETERMINISTIC_PROVIDER_RETRY`	503	Comme l'indique le statut.
`CREDITS_REQUIRED`	402	Une opération réelle exige plus de crédits que l'espace de travail n'en détient.
`API_KEY_MISSING`	401	Aucun jeton porteur n'a été envoyé.
`API_KEY_INVALID`	401	Le jeton n'est pas une clé émise par TaxPio.
`API_KEY_REVOKED`	401	La clé a été révoquée; créez-en une nouvelle.
`API_KEY_EXPIRED`	401	La clé a dépassé sa date d'expiration.
`WORKSPACE_SUSPENDED`	403	L'espace de travail n'est pas actif.
`APPLICATION_ARCHIVED`	403	L'application a été archivée; ses clés ne fonctionnent plus.
`SCOPE_REQUIRED`	403	Il manque à la clé la portée dont l'opération a besoin (required_scope l'indique).
`PRODUCTION_REVIEW_REQUIRED`	403	Une clé réelle a été utilisée avant que l'examen de production approuve l'espace de travail.
`IDEMPOTENCY_KEY_INVALID`	400	Idempotency-Key ne compte pas de 8 à 128 caractères parmi les lettres, les chiffres et _ - . :.
`IDEMPOTENCY_KEY_REUSED`	409	La même clé a été envoyée avec un autre corps.
`IDEMPOTENCY_KEY_IN_PROGRESS`	409	La première demande avec cette clé est encore en cours.
`BODY_INVALID`	400	Le corps n'est pas un JSON valide.
`UNSUPPORTED_PROGRAM`	422	La juridiction, le programme ou l'année d'imposition n'est pas offert (le message indique ce qui l'est).
`SANDBOX_ONLY`	403	Un outil de bac à sable a été appelé avec une clé réelle.
`CONNECTION_PENDING`	409	Comme l'indique le statut.
`CONNECTION_REVOKED`	409	Comme l'indique le statut.
`CONNECTION_PERMISSION_REQUIRED`	403	Comme l'indique le statut.
`LIVE_ONLY`	403	Une opération liée au gouvernement a été appelée avec une clé de bac à sable.
`WEBHOOK_SIGNATURE_INVALID`	401	Le collecteur n'a pas pu vérifier la signature de la livraison.