Passer au contenu principal

Les erreurs API

Les diffĂ©rentes erreurs que vous pourriez rencontrer lors de l'exĂ©cution de vos requĂȘtes.

Mis Ă  jour cette semaine

Lorsque vous exĂ©cutez vos requĂȘtes, il se peut que vous ayez une erreur en rĂ©sultat.


Les différents codes erreurs

Voici les différentes erreurs que vous pourriez rencontrer :

  • 400 Bad Request : Cette erreur est renvoyĂ©e quand il y a des erreurs dans la requĂȘte. En gĂ©nĂ©ral, l’erreur est indiquĂ©e Ă  la suite.

  • 400 Payment required : Cette erreur est renvoyĂ©e quand la personne qui a créé les tokens ne dispose pas de la licence nĂ©cessaire pour exĂ©cuter la requĂȘte (Exemple : une crĂ©ation d’opportunitĂ© sans avoir de licence de vente).

  • 401 Unauthorized : Cette erreur est renvoyĂ©e lorsque l'authentification est non valide. Cela se prĂ©sentera quand il y a un problĂšme d’identification avec les tokens sur l’environnement. Cette erreur peut aussi ĂȘtre constatĂ©e lorsque les tokens sont demandĂ©s par deux scripts distincts (Jeton rĂ©voquĂ© par un autre) ou lorsque le crĂ©ateur des tokens API n'a plus d'accĂšs Ă  Sellsy.

  • 403 Forbidden : Cette erreur est renvoyĂ©e lorsque l'authentification fournie ne possĂšde pas les autorisations nĂ©cessaires pour accĂ©der Ă  l'URL spĂ©cifique. Par exemple, un jeton OAuth qui dispose uniquement d'un accĂšs Ă  la facturation recevra une rĂ©ponse 403 lors d’une requĂȘte d’opportunitĂ©s (qui nĂ©cessite une licence vente).

  • 400 Payment required : Cette erreur est renvoyĂ©e quand la personne qui a créé les tokens ne dispose pas de la licence nĂ©cessaire pour exĂ©cuter la requĂȘte (Exemple : une crĂ©ation d’opportunitĂ© sans avoir de licence de vente).

  • 429 Too many requests : Cette erreur est renvoyĂ©e quand votre compte ou application dĂ©passe ses limites quant aux API. Nous recommandons de mettre un dĂ©lai de 200 MS entre chaque appel pour un bon traitement des donnĂ©es. GĂ©nĂ©ralement, une optimisation du code permet de rĂ©soudre le problĂšme (Utilisation mĂ©thode de batch).

  • 500 Internal server error : Ce code d'erreur indique que le serveur est temporairement indisponible ou en maintenance. Ce message vous indique donc que votre site est en ligne et qu'il fonctionne, mais qu'il est actuellement et temporairement inaccessible.

  • 502 Bad Gateway : Cette erreur se produit lors de la mise Ă  jour du serveur API pendant un laps de temps trĂšs court. Pour s’en prĂ©munir, il suffit de mettre en place une approche de retry.


Les erreurs de process

Les erreurs de process sont renvoyées par l'API dans l'objet réponse. Chaque erreur possÚde un identifiant, ce qui vous permet de personnaliser les messages. Voici les différentes erreurs de process que vous pourriez rencontrer :

  • E_USER_NOT_LOGGED : L'utilisateur n'est pas connectĂ©.

  • E_IO_MODE_DONT_EXIST : Le mode d'input/output n'existe pas.

  • E_IO_MODE_DO_IN_MISSING : L’attribut DO_IN de l’API V1 est manquant.

  • E_DO_IN_WRONG_FORMAT : Le format d'entrĂ©e est mauvais.

  • E_METHOD_DONT_EXIT : La mĂ©thode spĂ©cifiĂ©e n'existe pas.

  • E_DO_IN_PARAM_MISSING : Le paramĂštre DO_IN est manquant.

  • E_PRIV_NOT_ALLOWED : L'utilisateur ne dispose pas des privilĂšges pour accĂ©der Ă  cette ressource.

  • E_SUBSCRIBE_HAVETO : L'utilisateur a besoin de souscrire Ă  un abonnement pour accĂ©der Ă  cette ressource.

  • E_PARAM_MISSING : Le paramĂštre est manquant.

  • E_PARAM_INVALID : Le paramĂštre est invalide.

  • E_PARAM_REQUIRED : Le paramĂštre est manquant ou incorrect et il est obligatoire.

  • E_OBJ_NOT_LOADABLE : La valeur passĂ©e ne fait pas rĂ©fĂ©rence Ă  un objet utilisable pour cet appel.

  • E_OBJ_NOT_EDITABLE : Un objet n’est plus modifiable (Facture finalisĂ©e).

  • E_OBJ_NOT_LOADED : L'objet n'est pas chargĂ©.

  • E_LIST_DONT_EXIST : La liste n'existe pas.

  • E_LIST_VALUE_DONT_EXIST : La valeur demandĂ©e n'existe pas dans la liste.

  • E_PAGINATION_MAX : Le paramĂštre pagination est incorrect.

  • E_UNKNOW : Erreur inconnue.

  • E_CUSTOM : Erreur manuelle.

  • E_CORPORATION_BLOCKED : Account blocked. Contact us.

  • E_PLUGIN_NOT_LOADED : Plugin is not loaded.

  • E_QUOTA_NOT_SUFFICIENT : Quota for plugin is insufficient.

  • E_FEATURE_DISABLED : Feature is disabled, you need to upgrade your account.

  • E_LICENCE_BLOCKED : Current licence is blocked.

  • E_LICENCE_NO : No licence available.

  • E_LIMIT_REQUEST_REACHED : You reached the limit of requests. Please contact us for further informations.

  • E_SERVICE_UNVAILABLE : We can not perform your request. Please re-try later.

Avez-vous trouvé la réponse à votre question ?