Tout ce que l’API possède avant un produit : la forme de votre requête, votre compte et votre organisation, les quotas, les sessions et les pannes propres à l’API.
Cherchez votre code ci-dessous : il y en a 47. Le chiffre placé entre les lettres et le tiret indique qui peut agir : 1, quelque chose que vous pouvez corriger ; 2 et 9, une panne que Quavern doit réparer ; 3, 4 et 5, une décision d’accès ; 6 et 7, une maintenance ou un service déplacé ; 8, l’appareil ou le réseau. APIE utilise 1, 2, 6. La forme d’un code est expliquée dans Comment lire un code d’assistance Quavern.
Classe 1 — Requête ou action client
Vérifiez ce que vous avez envoyé et l’état du compte : la requête elle-même, un quota, ou l’objet qu’elle désigne. Corriger cela puis réessayer suffit normalement.
APIE1-0404 — not_found
Ce que cela signifie. Rien n’est servi à la route appelée, ou l’objet désigné par son URL n’existe pas.
Ce code porte le statut HTTP générique 404.
Ce qu’il faut faire. Vérifiez le chemin, puis l’identifiant qu’il contient.
APIE1-0405 — method_not_allowed
Ce que cela signifie. La méthode HTTP utilisée ne fait pas partie de ce que cette route accepte.
Ce code porte le statut HTTP générique 405.
Ce qu’il faut faire. Consultez les méthodes documentées pour cette route.
APIE1-0415 — unsupported_media_type
Ce que cela signifie. Le type de média envoyé ne fait pas partie de ce que Quavern traite sur cette route.
Ce code porte le statut HTTP générique 415.
Ce qu’il faut faire. Utilisez une des formes que la documentation indique pour cette route.
APIE1-0429 — rate_limited
Ce que cela signifie. Les requêtes sont arrivées plus vite que Quavern ne l’accepte ici. Ce que vous avez envoyé n’est pas en cause.
Ce code porte le statut HTTP générique 429.
Ce qu’il faut faire. Patientez, puis réessayez plus lentement. Respectez l’en-tête Retry-After lorsque la réponse en comporte un.
APIE1-1001 — validation_error
Ce que cela signifie. Un ou plusieurs des champs de la requête n’ont pas passé la validation. Quavern a refusé la requête entière avant toute modification.
Ce qu’il faut faire. Lisez l’objet details de la réponse : il nomme les champs en cause.
APIE1-1002 — invalid_json
Ce que cela signifie. Quavern a refusé le corps JSON : ce qui est arrivé n’a pas la forme attendue sur cette route.
APIE1-1003 — json_required
Ce que cela signifie. La requête ne peut pas aboutir sans le corps JSON.
APIE1-1004 — payload_too_large
Ce que cela signifie. Le corps de la requête dépasse la taille acceptée sur cette route.
Ce qu’il faut faire. Envoyez un élément plus petit, ou découpez-le en plusieurs requêtes.
APIE1-1005 — confirmation_required
Ce que cela signifie. La requête ne peut pas aboutir sans une confirmation explicite.
APIE1-1006 — account_exists
Ce que cela signifie. Le compte se trouve déjà dans l’état demandé : Quavern n’a donc rien fait plutôt que de le faire deux fois.
Ce qu’il faut faire. Rien n’est cassé. Relisez l’état actuel avant de répéter l’étape.
APIE1-1007 — account_not_found
Ce que cela signifie. La requête désigne le compte, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1008 — unknown_service
Ce que cela signifie. Le service désigné n’est pas reconnu par Quavern.
Ce qu’il faut faire. Utilisez une des valeurs indiquées par la documentation.
APIE1-1009 — organization_required
Ce que cela signifie. La requête ne peut pas aboutir sans l’organisation concernée.
APIE1-1010 — organization_not_found
Ce que cela signifie. La requête désigne l’organisation, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1011 — organization_forbidden
Ce que cela signifie. Quavern a refusé l’action portant sur l’organisation. L’appelant est bien identifié ; il n’a pas le droit de faire cela.
APIE1-1012 — membership_not_found
Ce que cela signifie. La requête désigne l’adhésion, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1013 — membership_forbidden
Ce que cela signifie. Quavern a refusé l’action portant sur l’adhésion. L’appelant est bien identifié ; il n’a pas le droit de faire cela.
APIE1-1014 — owner_required
Ce que cela signifie. Seul le propriétaire de l’organisation peut le faire, et le compte à l’origine de la requête ne l’est pas.
Ce qu’il faut faire. Demandez au propriétaire de le faire, ou de transférer d’abord la propriété.
APIE1-1015 — seat_limit_reached
Ce que cela signifie. Le nombre de sièges de l’organisation atteint déjà le maximum autorisé sur ce compte ou cette offre : un de plus a donc été refusé.
Ce qu’il faut faire. Supprimez-en un devenu inutile, ou passez à une offre au plafond plus élevé.
APIE1-1016 — current_session
Ce que cela signifie. Quavern n’a pas publié la signification de ce code. Son nom ne la fixe pas, et cette page ne la devinera pas — le nom désigne une chose, pas une panne : il ne dit pas si la session en question ne peut pas être révoquée, ne peut pas être remplacée, ou autre chose encore.
Ce qu’il faut faire. Citez le code à l’assistance ([email protected]), avec l’heure et ce que vous étiez en train de faire : sa signification vous sera indiquée.
APIE1-1017 — session_not_found
Ce que cela signifie. La requête désigne la session, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1018 — token_not_found
Ce que cela signifie. La requête désigne le jeton, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1019 — membership_exists
Ce que cela signifie. L’adhésion se trouve déjà dans l’état demandé : Quavern n’a donc rien fait plutôt que de le faire deux fois.
Ce qu’il faut faire. Rien n’est cassé. Relisez l’état actuel avant de répéter l’étape.
APIE1-1020 — organization_over_capacity
Ce que cela signifie. La capacité de l’organisation est épuisée — pour la période en cours, ou pour ce que cette offre autorise.
Ce qu’il faut faire. Attendez le renouvellement de la période, ou passez à une offre qui en autorise davantage.
APIE1-1021 — account_deletion_blocked_subscription
Ce que cela signifie. Quavern ne mènera pas à bien la suppression du compte : un abonnement actif s’y oppose.
Ce qu’il faut faire. Réglez d’abord ce qui s’y oppose, puis redemandez.
APIE1-1022 — account_deletion_blocked_owner
Ce que cela signifie. Quavern ne mènera pas à bien la suppression du compte : le compte est encore propriétaire d’une organisation.
Ce qu’il faut faire. Réglez d’abord ce qui s’y oppose, puis redemandez.
APIE1-1023 — account_deletion_blocked_billing
Ce que cela signifie. Quavern ne mènera pas à bien la suppression du compte : une situation de facturation non soldée s’y oppose.
Ce qu’il faut faire. Réglez d’abord ce qui s’y oppose, puis redemandez.
APIE1-1024 — ownership_transfer_target_invalid
Ce que cela signifie. Le compte désigné comme nouveau propriétaire n’est pas accepté ici : les conditions demandées ne sont pas réunies.
APIE1-1025 — ownership_transfer_conflict
Ce que cela signifie. Une autre modification portant sur le transfert de propriété était en cours : Quavern a refusé celle-ci plutôt que de laisser les deux s’écraser.
Ce qu’il faut faire. Rechargez l’état actuel et reprenez la modification.
APIE1-1026 — account_deletion_conflict
Ce que cela signifie. Une autre modification portant sur la suppression du compte était en cours : Quavern a refusé celle-ci plutôt que de laisser les deux s’écraser.
Ce qu’il faut faire. Rechargez l’état actuel et reprenez la modification.
APIE1-1027 — ownership_transfer_blocked_subscription
Ce que cela signifie. Quavern ne mènera pas à bien le transfert de propriété : un abonnement actif s’y oppose.
Ce qu’il faut faire. Réglez d’abord ce qui s’y oppose, puis redemandez.
APIE1-1028 — email_unavailable
Ce que cela signifie. L’adresse e-mail ne peut pas être utilisée ici : un autre élément l’occupe déjà, ou Quavern ne l’autorise pas sur ce compte.
Ce qu’il faut faire. Choisissez une autre valeur.
APIE1-1029 — mfa_already_enabled
Ce que cela signifie. Le second facteur se trouve déjà dans l’état demandé : Quavern n’a donc rien fait plutôt que de le faire deux fois.
Ce qu’il faut faire. Rien n’est cassé. Relisez l’état actuel avant de répéter l’étape.
APIE1-1030 — mfa_not_enabled
Ce que cela signifie. Le second facteur n’est pas activé sur ce compte, et cette route ne fonctionne pas sans.
Ce qu’il faut faire. Activez-le d’abord depuis la page du compte.
APIE1-1031 — mfa_setup_required
Ce que cela signifie. La requête ne peut pas aboutir sans la vérification en deux étapes configurée sur le compte.
APIE1-1032 — memory_not_found
Ce que cela signifie. La requête désigne la mémoire, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1033 — folder_not_found
Ce que cela signifie. La requête désigne le dossier, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1034 — share_not_found
Ce que cela signifie. La requête désigne le partage, et Quavern n’en a aucune trace : soit cet élément n’a jamais existé, soit il a été supprimé, soit il appartient à un autre compte.
Ce qu’il faut faire. Vérifiez l’identifiant envoyé, puis vérifiez que vous utilisez bien le compte propriétaire.
APIE1-1035 — folder_exists
Ce que cela signifie. Le dossier se trouve déjà dans l’état demandé : Quavern n’a donc rien fait plutôt que de le faire deux fois.
Ce qu’il faut faire. Rien n’est cassé. Relisez l’état actuel avant de répéter l’étape.
APIE1-1036 — memory_capacity_exceeded
Ce que cela signifie. La capacité de mémoire est épuisée — pour la période en cours, ou pour ce que cette offre autorise.
Ce qu’il faut faire. Attendez le renouvellement de la période, ou passez à une offre qui en autorise davantage.
APIE1-1429 — quota_exhausted
Ce que cela signifie. Le quota est épuisé — pour la période en cours, ou pour ce que cette offre autorise.
Ce qu’il faut faire. Attendez le renouvellement de la période, ou passez à une offre qui en autorise davantage.
Classe 2 — Serveur Quavern ou une de ses dépendances
Rien de ce que vous avez fait n’en est la cause. Patientez un instant puis réessayez. Si cela persiste, envoyez à l’assistance le code et l’heure : c’est ce qui permet de retrouver l’incident dans les journaux.
APIE2-0502 — bad_gateway
Ce que cela signifie. La liaison entre la façade et l’API a échoué. La défaillance est du côté de Quavern, pas dans ce que vous avez envoyé.
Ce code porte le statut HTTP générique 502.
*Depuis le registre (en anglais) :* Generated by nginx on the API hosts when the application is unreachable (marl/deploy/quavern-errors/*.json); registered so the edge and the application can never answer the same condition with two codes.
APIE2-0503 — service_unavailable
Ce que cela signifie. Le service d’API n’a pas répondu, et cette route ne peut pas être servie sans cela.
Ce code porte le statut HTTP générique 503.
APIE2-0504 — gateway_timeout
Ce que cela signifie. La liaison entre la façade et l’API n’a pas répondu dans le délai que Quavern accepte d’attendre.
Ce code porte le statut HTTP générique 504.
APIE2-1500 — internal_error
Ce que cela signifie. Le traitement de cette requête par l’API a échoué. La défaillance est du côté de Quavern, pas dans ce que vous avez envoyé.
APIE2-1501 — storage_error
Ce que cela signifie. La couche de stockage a échoué. La défaillance est du côté de Quavern, pas dans ce que vous avez envoyé.
Classe 6 — Maintenance déclarée
Quavern se trouve dans une fenêtre de maintenance annoncée. Consultez https://status.quavern.net et réessayez une fois la fenêtre close.
APIE6-1503 — maintenance
Ce que cela signifie. Quavern a déclaré une fenêtre de maintenance et refuse cette route pendant toute sa durée.
Toujours bloqué
Écrivez à [email protected] en indiquant le code, le reason, l’heure avec son fuseau, et la route appelée. N’envoyez jamais de mot de passe, de jeton, de clé d’API ni de données de carte complètes : l’assistance ne vous les demandera jamais.
Référence d’aide Quavern : support-codes-apie/fr
