Information importante

Pour pouvoir communiquer avec notre API, votre client API doit supporter l‘extension TLS SNI. Plus d'informations sur notre blog.

En utilisant l'API de Sellsy, vous pourrez être confronté à deux types d'erreurs :

  • Les erreurs OAuth - Lors d'une transaction, les erreurs OAuth sont renvoyées par le serveur OAuth avant que le traitement n'ait commencé. Elles sont considérées comme importantes lorsqu'une erreur OAuth est renvoyée. L'utilisateur éventuellement connecté est immédiatement déconnecté.
  • Les erreurs Process - Elles sont générées lors du traitement de votre requête. Leur retour s'effectue dans la réponse de l'API (dans le JSON par exemple). Elles ne sont pas considérées comme importantes et l'utilisateur conserve sa session. L'application cliente doit prendre en charge ces erreurs, par exemple pour ne pas perdre le contenu d'une interface de saisie.

Elles sont renvoyées par l'API sous forme d'une chaîne de caractères.

Elles 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érents messages que vous pourrez 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 - Le mode d'input/output 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 - Un objet n'est pas chargeable
  • E_OBJ_NOT_EDITABLE - Un objet n'est pas éditable
  • 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