Skip to content

Codes d'erreur

Chaque statut HTTP renvoyé par l'API publique et Discovery, puis les messages d'erreur fréquents par domaine, avec leur cause et leur résolution.

ReferenceDeveloper

This page has not been translated yet and is shown in French.

Cette page recense les erreurs que renvoient l'API publique https://api.wakastart.app/api et Discovery https://discovery.wakastart.app. Les messages sont cités tels que l'API les renvoie : copiez-les dans la recherche de la page pour retrouver leur cause.

Format d'une erreur

L'API publique renvoie toujours ce corps :

JSON
{
  "statusCode": 409,
  "message": "Une invitation est déjà en cours pour cet email",
  "error": "Conflict",
  "timestamp": "2026-10-23T09:12:44.512Z",
  "path": "/api/invitations"
}
  • message est une chaîne, ou un tableau de chaînes pour une erreur de validation.
  • error est un libellé indicatif ; il peut valoir Internal Server Error sur une erreur 4xx. Fondez votre traitement sur statusCode et message.
  • Discovery renvoie un corps plus court, sans timestamp ni path : { "statusCode": 404, "message": "not_found", "error": "Not Found" }.
  • Les endpoints du module HDS renvoient le corps d'erreur du module tel quel.

Le détail du format est dans Conventions. Quand vous contactez le support, joignez timestamp, path et le message exact.

Statuts HTTP

200 OK avec un résultat négatif

Quelques endpoints signalent un échec métier dans une réponse 200, sans statut d'erreur :

EndpointRéponseSignification
GET /api/invitations/verify/{token}{ "valid": false, "errorMessage": "…" }Lien inutilisable : voir Invitations
POST /api/auth/enrich{}Le jeton Keycloak envoyé est expiré ou refusé
POST /api/import/userserrors non videCertaines lignes du CSV ont été ignorées
POST /api/token/authorize{ "allowed": false, "tokenValid": false }Le jeton de l'utilisateur est invalide
Discovery GET /discover/email{ "users": [] }Aucun compte pour cet e-mail et ce front, ou domain qui ne correspond à aucun hôte IAM de l'application
POST /api/app-keys/introspect{ "active": false }La clé présentée à votre wakapp n'est pas acceptée : voir Clés API des wakapps

400 Bad Request

Cause : requête mal formée. Champ obligatoire absent, champ inconnu, type ou format incorrect (UUID, WID, e-mail, URL), fichier absent ou d'un type refusé, paramètre d'environnement fourni alors qu'il est déduit de l'appelant, ou règle métier non respectée.

Résolution : lisez message ; pour une erreur de validation, il liste chaque champ en défaut. Voir Erreurs de validation.

401 Unauthorized

Cause : aucune identité valide. Jeton absent ou expiré, clé API inconnue, inactive ou expirée, jeton enrichi révoqué.

Résolution : renouvelez le jeton auprès de Keycloak, ou vérifiez la clé. Voir Erreurs d'authentification et d'accès.

402 Payment Required

Cause : solde de crédits insuffisant pour une opération payante (import d'utilisateurs, traduction par IA, scan antivirus).

Résolution : achetez un pack de crédits, puis relancez l'opération.

403 Forbidden

Cause : l'appelant est identifié mais n'a pas le droit d'agir. Niveau d'administration trop faible, droit applicatif ou rôle HDS absent, jeton émis pour une autre application, ressource hors de son périmètre, clé API sans portée, ressource système protégée, quota atteint.

Résolution : lisez message, qui nomme le droit ou le niveau manquant. Voir Erreurs d'authentification et d'accès.

404 Not Found

Cause : ressource inconnue, ou invisible pour l'appelant. Discovery répond aussi 404 not_found pour un nom d'hôte non déclaré.

Résolution : vérifiez l'identifiant (WID ou UUID selon le paramètre) et l'environnement de l'appel.

408 Request Timeout

Cause : opération du module HDS de plus de 30 secondes (Request timed out).

Résolution : réessayez ; pour un gros fichier, vérifiez votre débit montant.

409 Conflict

Cause : doublon (La valeur du champ "<champs>" existe déjà. Veuillez en choisir une autre.), suppression bloquée par des objets rattachés, utilisateur ou invitation déjà existants, utilisateur ambigu sur GET /api/me, ventes fermées ou compte Stripe pas encore apte à encaisser.

Résolution : lisez message ; supprimez d'abord les objets rattachés, ou modifiez l'objet existant au lieu d'en créer un.

413 Payload Too Large

Cause : fichier trop volumineux (File too large) : 2 Mo pour un CSV d'import, 100 Mo pour l'antivirus et le module HDS, ou quota de stockage HDS dépassé (Storage quota exceeded).

Résolution : réduisez ou découpez le fichier. Voir Limites et quotas.

429 Too Many Requests

Cause : limite de débit atteinte pour votre adresse IP (ThrottlerException: Too Many Requests).

Résolution : attendez le nombre de secondes indiqué par l'en-tête Retry-After-short, Retry-After-medium ou Retry-After-long, puis réessayez avec un délai croissant. Voir Limites de débit.

500 Internal Server Error

Cause : erreur inattendue (Internal server error, sans détail), ou échec d'un service tiers relayé : création de compte Keycloak, envoi d'e-mail, service de crédits, moteur de traduction.

Résolution : réessayez une fois. Si l'erreur persiste, contactez le support avec timestamp et path.

502 Bad Gateway

Cause : un service interne de Wakastart ou un fournisseur (Stripe) a répondu de façon inattendue ; le message commence alors par Erreur inattendue lors de l'appel à.

Résolution : réessayez après quelques secondes.

503 Service Unavailable

Cause : service momentanément indisponible ou délai dépassé (<chemin> service unavailable, HDS service unavailable, Antivirus service unavailable), ou vérification de révocation indisponible pour une application HDS (Auth check unavailable).

Résolution : réessayez avec un délai croissant. Ces erreurs ne modifient aucune donnée.

Erreurs d'authentification et d'accès

StatutMessageCauseRésolution
401Authentification requise: Bearer token (Authorization header) ou cle API (x-api-key header)Aucune identité valide : en-tête absent, jeton expiré, clé refuséeRenouvelez le jeton ou vérifiez la clé
401Cle API manquante (header x-api-key)L'endpoint n'accepte qu'une clé APIEnvoyez une clé dans x-api-key
401Cle API utilisateur invalide ou expireeL'endpoint n'accepte qu'une clé API et celle-ci est refuséeVérifiez l'état et l'expiration de la clé
401Token revokedJeton enrichi révoqué, par exemple après la désactivation de l'utilisateurReconnectez l'utilisateur
401Token enrichi valide requis — authentifiez-vous avec un Bearer token ou une clé API valideLecture du journal d'audit sans identité valideAuthentifiez l'appel
401Keycloak ID manquant dans le contexte utilisateurGET /api/me sans identité d'utilisateurAppelez avec le jeton de l'utilisateur
401Environment cannot be deduced: token has no wenv claimLe jeton ne porte pas d'environnementReconnectez l'utilisateur par le parcours de connexion de l'application
401Environment cannot be deduced: session has no environmentGET /api/me avec une session sans environnementReconnectez l'utilisateur par le parcours de connexion de l'application
403Environment cannot be deduced: API key has no environmentClé API sans environnementDemandez une clé rattachée à un environnement
400Environment is deduced from the caller and cannot be providedLa requête porte un paramètre env, envType ou envs. L'environnement est celui du jeton ou de la cléRetirez le paramètre ; pour un autre environnement, appelez avec un jeton ou une clé de cet environnement
400Environment cannot be deduced: import requires the caller environmentImport d'utilisateurs appelé sans environnement déductibleLancez l'import avec un jeton ou une clé rattachés à l'environnement visé
403Niveau d'administration insuffisant. Requis: <niveau>, Actuel: <niveau>Niveau trop faible pour l'endpointUtilisez un compte ou une clé de niveau suffisant
403Droit applicatif requis : <code>Le profil ne porte pas le droit, ou l'appel utilise le seul jeton enrichiAjoutez le droit au profil, ou envoyez le jeton Keycloak
403Rôle(s) HDS requis: <rôles> (mode: any)Aucun rôle HDS, ou appel avec le seul jeton enrichiAttribuez un rôle HDS ; envoyez le jeton Keycloak
403Access denied: token authorized party (azp) is missingLe jeton ne désigne aucune applicationUtilisez le jeton délivré à votre application
403Access denied: application context is missingLe jeton ne porte pas l'applicationVérifiez l'accès de l'utilisateur à l'application dans cet environnement
403Access denied: token authorized party does not match the target applicationJeton ou clé d'une autre applicationUtilisez le jeton de l'application appelée
403Access denied: application configuration unavailableVérification momentanément impossibleRéessayez
403API key without tenant scope cannot list tenant dataClé API sans client, réseau ni applicationDemandez une clé liée à votre client
503Auth check unavailableApplication HDS : vérification de révocation indisponibleRéessayez après quelques secondes

Erreurs de validation

StatutMessageCauseRésolution
400property <nom> should not existChamp non documenté dans le corps ou la requêteRetirez le champ
400<champ> must be an email, <champ> must be a UUID, <champ> must not be greater than <n>…Valeur hors contrainteCorrigez la valeur
400Validation failed (<param> must be a valid WID - 6 alphanumeric characters)WID mal formé dans le cheminEnvoyez 6 caractères alphanumériques
400Validation failed (<param> must be a valid WID (6 alphanumeric chars) or UUID)Identifiant mal forméEnvoyez un WID ou un UUID
400Validation failed (uuid is expected)Le chemin attend un UUIDEnvoyez l'UUID de l'objet

Utilisateurs et organisations

StatutMessageCauseRésolution
403Cannot assign adminLevel <niveau>: exceeds caller privilege ceiling (<niveau>)Niveau demandé supérieur à celui de l'appelantDemandez un niveau au plus égal au vôtre
403Cannot assign hdsRole <rôle>: caller does not possess this roleRôle HDS que l'appelant ne possède pasFaites l'attribution avec un compte qui a ce rôle
403User not found or not accessibleUtilisateur inconnu ou hors de votre périmètreVérifiez le WID
403Accès refusé à ce customer, Accès refusé à ce réseau, Accès refusé à cette applicationObjet hors de votre périmètreVérifiez l'identifiant
403Niveau d'administration insuffisant pour créer un customerCréation de client réservée aux administrateurs réseauFaites créer le client par un administrateur réseau
404User with WID <wid> not found, Customer with WID <wid> not found, Network with WID <wid> not found, App with WID <wid> not foundObjet inconnuVérifiez l'identifiant
404Utilisateur non trouvéGET /api/me : compte sans fiche Wakastart pour l'applicationVérifiez que l'utilisateur a accès à l'application
409Impossible de résoudre l'utilisateur de façon unique (customerId manquant ou invalide)GET /api/me : le compte appartient à plusieurs clientsReconnectez l'utilisateur en choisissant son organisation
409La valeur du champ "<champs>" existe déjà. Veuillez en choisir une autre.Doublon (e-mail dans un client, sous-domaine, nom)Choisissez une autre valeur ou modifiez l'objet existant
409Un utilisateur <email> existe déjà pour ce client dans l'environnement <env>Création d'un utilisateur dont l'adresse a déjà une fiche chez ce client, dans cet environnementModifiez la fiche existante ; une fiche dans un autre environnement n'empêche pas la création
409Impossible de supprimer cet utilisateur car il possède encore des profils…Suppression bloquéeRetirez d'abord profils et équipes
409Impossible de supprimer ce client car il possède encore des utilisateurs…Suppression bloquéeRetirez d'abord utilisateurs, équipes et fournisseurs d'identité
409Impossible de supprimer le Network "<wid>" : <n> customer(s), <n> host route(s) et <n> network config(s) y sont encore rattachés. Supprimez-les explicitement avant de supprimer ce Network.Réseau non videSupprimez d'abord ses clients et ses hôtes
503Impossible de joindre l'instance Keycloak [<env>] pour vérifier <email> : <détail>. Réessayez.Keycloak de l'environnement injoignableRéessayez

Équipes, profils et droits

StatutMessageCauseRésolution
403Vous n'avez pas les droits pour modifier cette équipe (ou supprimer, ajouter des membres à, retirer des membres de, modifier les niveaux dans)Niveau trop faible dans l'équipeFaites l'opération avec un administrateur ou un manager de l'équipe
409Impossible de supprimer cette équipe car elle possède encore des membres. Retirez d'abord les membres de l'équipe.Équipe non videRetirez les membres
403Les profils système ne peuvent pas être modifiés (ou supprimés)Profil systèmeCréez un profil personnalisé
403Les droits système ne peuvent pas être modifiés (ou supprimés)Droit système—
409Maximum 200 rights allowed per appPlafond de droits atteintSupprimez des droits inutilisés
409Right with code '<code>' already exists for this appCode déjà prisChoisissez un autre code
409Maximum 50 features allowed per appPlafond de fonctionnalités atteintSupprimez des fonctionnalités
409Impossible de supprimer ce profil car il est encore attribué à des utilisateurs…Profil encore utiliséRetirez d'abord les attributions

Invitations

StatutMessageCauseRésolution
400Invalid invitation token formatJeton différent de 64 caractères hexadécimaux minusculesUtilisez le lien reçu sans le modifier
200 / 400Invitation non trouvée, Cette invitation a déjà été acceptée, Cette invitation a expiré, Cette invitation a été annuléeLien inutilisableDemandez une nouvelle invitation ou une relance
400Fournir exactement un des champs customerId ou customerWidChamps exclusifs mal renseignésEnvoyez un seul des deux
400Email invalide, Les emails jetables ne sont pas autorisésAdresse refuséeUtilisez une adresse réelle
400Le realm du network n'est pas provisionné sur l'instance '<env>'. …Environnement pas encore prêt pour ce réseauContactez le support
403Vous devez avoir au minimum le niveau CUSTOMER_ADMIN pour inviter des utilisateursNiveau insuffisant—
400Environment is deduced from the caller and cannot be providedChamp envType envoyé : l'invitation est toujours créée dans l'environnement de l'inviteurRetirez le champ ; pour inviter dans un autre environnement, appelez avec un jeton ou une clé de cet environnement
403La fonctionnalité invitation n'est pas activée pour ce customerInvitations désactivéesActivez les invitations de l'application
403Limite d'invitations atteinte (<n> par mois). Réessayez plus tard.Quota de l'inviteur atteintAttendez, ou demandez le relèvement de la limite
403Customer <id> is outside the caller's tenant scopeClient hors de votre périmètreInvitez dans votre propre client
409Un utilisateur avec cet email existe déjàCompte déjà présent dans ce client, dans l'environnement de l'inviteurAttribuez-lui un profil au lieu de l'inviter
409Une invitation est déjà en cours pour cet emailInvitation en attente dans ce client, dans l'environnement de l'inviteurRelancez l'invitation existante
500La création de l'invitation a échoué à l'envoi de l'emailE-mail non partiVérifiez le compte d'envoi de l'application, puis réessayez

Import d'utilisateurs

StatutMessageCauseRésolution
400Seuls les fichiers CSV sont acceptesFichier d'un autre typeEnvoyez un fichier .csv
400Fichier CSV requisAucun fichier dans le champ fileJoignez le fichier dans file
400Le fichier CSV est videAucune ligne—
400Le fichier CSV contient <n> lignes, maximum autorise: 500Fichier trop longDécoupez-le
400Erreur de parsing CSV: <détail>CSV mal forméVérifiez séparateurs et guillemets
400Missing customer contextAppel sans clientAppelez avec un compte ou une clé rattachés à un client
402Insufficient creditsSolde insuffisantAchetez un pack de crédits
403Vous ne pouvez importer que dans votre propre customerClient cible différent du vôtreImportez dans votre client
413File too largeFichier de plus de 2 MoDécoupez-le

Contenus et traductions

StatutMessageCauseRésolution
403Access denied: you can only access the runtime config of your own applicationConfiguration d'une autre applicationUtilisez le WID de votre application
403Access denied to this applicationTraductions d'une application hors de votre périmètre—
404Theme with ID <id> not foundThème inconnuVérifiez l'identifiant
409This theme is already added to the appThème déjà associé—
400Cannot remove the default theme. Set another theme as default first.Retrait du thème par défautDéfinissez d'abord un autre thème par défaut
409Language with code "<code>" already existsLangue déjà au référentielUtilisez POST /api/languages/find-or-create
400La langue <nom> (<code>) est obligatoire et ne peut pas être suppriméeFrançais et anglais obligatoires—
409Translation key "<clé>" already exists for fileType <type>Clé déjà crééeModifiez sa valeur
404Translation file not found for app '<appWid>', lang '<code>', type '<type>'Aucun fichier publiéPubliez les traductions depuis la console
402Insufficient creditsTraduction par IA sans créditsAchetez un pack de crédits
500AI translation service unavailableMoteur de traduction indisponibleRéessayez

Clés API des wakapps

Les opérations /api/app-keys (voir Référence API : clés de votre wakapp) renvoient un code stable dans message, parfois accompagné d'un objet details. Fondez votre traitement sur ce code.

StatutCodeCauseRésolution
400UNKNOWN_RIGHTDroit absent du catalogue de l'application pour cet environnement (details.unknown)Corrigez le code du droit
400CONFLICTING_RIGHTSLe même droit est à la fois ajouté et retiré (details.rights)Envoyez-le dans une seule des deux listes
400IMMUTABLE_FIELDTentative de modifier le type, l'organisme, l'application ou l'environnement (details.fields)Créez une nouvelle clé
400CUSTOMER_REQUIREDClé technique sans customerWidIndiquez l'organisme
400APP_NOT_ENABLED_FOR_CUSTOMERL'application n'est pas activée pour l'organismeActivez l'application pour ce client
400PLATFORM_APP_FORBIDDENClé demandée sur l'application Wakastart elle-même—
400APP_TYPE_NOT_ALLOWEDL'application n'est pas de type Application (module, service)—
401CALLER_NOT_RESOLVEDLe compte de l'appelant est introuvable ou inactifReconnectez l'utilisateur
401USER_TOKEN_INVALIDuser-context : jeton de l'utilisateur refusé (signature, expiration) ou identité ambiguëEnvoyez un jeton d'accès valide
403RIGHTS_EXCEED_CEILINGUn droit demandé dépasse les droits de la personne qui agit (details.missing)Retirez ces droits ou faites agir une personne qui les détient
403KEY_TYPE_NOT_ALLOWEDL'appelant ne peut pas créer ce type de clé, ou fait tourner la clé liée d'un autre utilisateurUne clé technique est réservée aux administrateurs de l'organisme
403NOT_ORG_ADMINL'appelant est administrateur, mais pas de cet organisme—
403API_KEY_CANNOT_MANAGE_KEYSOpération de gestion appelée avec une clé sk_Appelez avec le jeton de l'utilisateur
403APP_SCOPE_MISMATCHappWid ou envType envoyé et différent de l'application ou de l'environnement du jetonN'envoyez ni l'un ni l'autre
403APP_NOT_RESOLVEDLe jeton ne désigne aucune application cliente (client inconnu, module, service, application de la plateforme)Utilisez le jeton émis pour votre wakapp
403CALLER_APP_KEY_REQUIREDintrospect ou user-context appelée sans clé sk_ valideEnvoyez la clé sk_ de votre wakapp dans x-api-key
403AZP_MISMATCHuser-context : jeton de l'utilisateur émis pour une autre applicationEnvoyez le jeton émis pour votre wakapp
403USER_TOKEN_ENV_MISMATCHuser-context : jeton d'un autre environnement que votre clé sk_Utilisez la clé sk_ du même environnement
403USER_NOT_MEMBERuser-context : utilisateur ou organisme inactif, ou sans accès à l'application—
403Access denied: token authorized party does not match the target application (pas de code stable)Le jeton de l'utilisateur a été émis pour une autre application que celle de son réseau. Ce contrôle passe avant tous les autresUtilisez le jeton émis pour votre wakapp
404NOT_FOUNDClé, application ou organisme inexistant, hors de la portée de l'appelant, ou d'une autre application ou d'un autre environnement que ceux du jetonVérifiez le WID
409KEY_REVOKEDModification ou rotation d'une clé révoquéeCréez une nouvelle clé
429—Limite de débit de introspect ou user-context atteinteAttendez la durée de l'en-tête Retry-After
503APP_KEYS_DISABLEDFonctionnalité momentanément indisponibleRéessayez plus tard
503APP_KEYS_UNAVAILABLEWakastart ne peut pas traiter la demande pour le momentRéessayez avec un délai croissant
503CONTEXT_SIGNING_UNAVAILABLEuser-context : Wakastart ne peut pas signer de contexte pour le moment ; à l'introspection, context_token est alors absentRéessayez

Une erreur de validation du corps (champ manquant, champ inconnu, format de droit invalide) renvoie le 400 habituel, avec la liste des messages de validation.

Réponses du kit à vos clients

Le kit @wakastellar/wakastart-keys répond ainsi aux clients qui appellent votre wakapp (voir Vérifier une clé de votre wakapp) :

StatutCodeCause
401APP_KEY_MISSINGPas d'en-tête Authorization: Bearer ; la réponse porte WWW-Authenticate: Bearer
401APP_KEY_INVALIDClé inconnue, révoquée, expirée, d'une autre application ou d'un autre environnement
403APP_KEY_RIGHTS_MISSINGDroit manquant, listé dans details.missing
503WAKASTART_UNAVAILABLEWakastart injoignable, délai dépassé ou réponse inattendue : la clé est refusée faute de vérification

Jeton de contexte

Un appel de l'API publique qui porte un jeton de contexte dans X-WakaStart-Context peut être refusé avec ces codes. En mode observe, ces refus sont seulement journalisés par Wakastart, sauf les deux dernières lignes, appliquées quel que soit le mode. En mode preferred, tous s'appliquent, sauf l'absence de contexte.

StatutCodeCause
403CONTEXT_REQUIREDAction en mode required ou bound appelée sans contexte
401CONTEXT_INVALIDContexte expiré (plus de 60 secondes), signature ou émetteur invalide, ou émis pour une autre application ou un autre environnement
403CONTEXT_CUSTOMER_MISMATCHL'organisme cible n'est pas celui du contexte
403CONTEXT_OBJECT_OUT_OF_SCOPEUn objet de la demande (profil, équipe, invitation, utilisateur) n'appartient pas à l'organisme du contexte, ou un niveau d'administration au-dessus d'Administrateur client est demandé
403CONTEXT_KEY_INACTIVEClé client révoquée, suspendue ou expirée depuis l'émission du contexte
403CONTEXT_AUTH_VERSION_STALEDroits ou statut de la clé client modifiés depuis l'émission du contexte
403CONTEXT_USER_INACTIVEContexte « utilisateur » : utilisateur désactivé ou sans accès à l'application
403CONTEXT_REPLAYEDMode bound : contexte déjà utilisé pour une action
503CONTEXT_UNVERIFIABLEWakastart ne peut pas vérifier le contexte, ou le mode de l'action, pour le moment : l'action est refusée, quel que soit le mode
403Access denied: token authorized party does not match the target application (pas de code stable)Requête portant le jeton d'un utilisateur émis pour une autre application que celle de son réseau, refusée avant tout contrôle de contexte, quel que soit le mode

Un même refus a le même statut et le même code, qu'il soit décidé à l'entrée de l'API ou au moment d'exécuter l'action.

Antivirus

Les erreurs du module antivirus sont renvoyées avec leur statut et le message générique Antivirus service error.

StatutMessageCause probableRésolution
400Fichier requisAucun fichier dans fileJoignez le fichier
400Antivirus service errorFichier refusé par la politique de scan (taille, type, extension), secret de rappel de plus de 64 caractères, appel sans client ni applicationVérifiez le fichier et les paramètres
402Antivirus service errorCrédits insuffisantsAchetez un pack de crédits
404Antivirus service errorScan inconnuVérifiez l'identifiant
413File too largeFichier de plus de 100 Mo—
503Antivirus service unavailableModule indisponibleRéessayez

HDS

StatutMessageCauseRésolution
403HDS path not allowedChemin non autoriséUtilisez un chemin documenté
403Insufficient HDS permissions for this operationRôle HDS insuffisant pour l'opérationVoir les rôles dans HDS
403Cannot delete document under legal hold, Cannot delete sealed documentDocument protégé—
400Vault quota exceeded: <n>/<max>, Document quota exceeded: <n>/<max>Quota du client atteintContactez le support
400Infected file detected — upload deniedFichier infecté—
404Vault not found: <id>, Document not found: <id>Objet inconnu ou non partagé avec vousVérifiez l'identifiant et les partages
408Request timed outOpération de plus de 30 secondesRéessayez
413Storage quota exceededStockage du client pleinContactez le support

Paiements et crédits

StatutMessageCauseRésolution
403Ce endpoint est réservé aux requêtes émises depuis une WakaAppAppel sans le jeton d'un utilisateur de l'applicationAppelez avec le jeton de l'utilisateur
400successUrl origin not allowed (ou cancelUrl, returnUrl)URL de retour hors des hôtes autorisésUtilisez une URL de votre application
400Une session de paiement exige au moins une ligne de commandelineItems vide—
404Aucune configuration de facturation pour l'application <appWid>Ventes non configuréesConfigurez la facturation dans la console
409Les ventes ne sont pas activées pour l'application <appWid>Ventes ferméesOuvrez les ventes dans la console
409Le compte Stripe Connect du Customer <wid> n'est pas encore apte à encaisserInscription Stripe incomplèteTerminez l'inscription Stripe
404Session <id> introuvable pour l'application <appWid>Session d'un autre utilisateur—
404Aucun historique de facturation pour ce clientL'utilisateur n'a jamais payé—
404Abonnement <id> inconnu pour <appWid>Abonnement d'un autre utilisateur—
400Pack inconnu : <code>. Valeurs attendues : STARTER, PRO, BUSINESS, ENTERPRISECode de pack invalideUtilisez un code de GET /api/pay/packs
403Missing customer/network context for credit pack purchaseAppelant sans client ni réseau—
402Insufficient creditsSolde insuffisant pour l'opérationAchetez un pack

Documents légaux

StatutMessageCauseRésolution
401Cle API manquante (header x-api-key)Appel avec un jeton au lieu d'une cléUtilisez une clé API
404Aucun document légal actif de type <type> pour cette applicationAucune version en vigueurPubliez le document dans la console
404LegalDocument "<id>" not foundVersion inconnueRelisez la liste des documents

Discovery

StatutMessageCauseRésolution
400email must be an emailAdresse absente ou mal formée—
400subdomain must contain only alphanumeric characters and hyphensSous-domaine invalide—
400property <nom> should not existParamètre non documentéRetirez-le
400invalid_requestPOST /discover/start-login sans hostEnvoyez toujours le nom d'hôte complet de la page
404not_foundAucun realm ne correspond au nom d'hôteEnvoyez le nom d'hôte complet ; faites déclarer l'hôte pour l'environnement
429ThrottlerException: Too Many RequestsLimite de débit atteinteAttendez avant de réessayer