Passer au contenu principal

API V1

Retrouvez l'ensemble de la documentation API V1 dans cet article.

Mis à jour il y a plus d’une semaine

Nous travaillons actuellement sur une nouvelle version de notre API. L’API V1 est toujours maintenue, mais elle ne fait plus l’objet de nouvelles Ă©volutions.

L’API V2 ne propose pas encore l’ensemble des fonctionnalitĂ©s disponibles dans l’API V1. Cette derniĂšre reste donc, pour le moment, nĂ©cessaire pour certains usages.

Documentation

La documentation de l'API V1 est disponible depuis https://api.sellsy.fr/

Sur le site de l'API, vous trouverez toutes les informations nécessaires pour :

  • Établir une connexion selon votre type d'authentification

  • Comprendre la structure des requĂȘtes et des rĂ©ponses

  • GĂ©rer les erreurs et codes de retour

La documentation de toutes les commandes disponibles est accessible depuis l'onglet "Documentation" > "MĂ©thodes".

CrĂ©ation d’un token

Pour utiliser l'API V1, vous devez d'abord créer un accÚs API et générer vos tokens d'authentification.

Accéder au Portail Développeur

  1. Depuis votre compte Sellsy, ouvrez le menu principal

  2. Accédez à "Réglages"

  3. Cliquez sur "Portail DĂ©veloppeur"

Créer une nouvelle application

  1. Depuis la page Portail DĂ©veloppeur, cliquez sur l'onglet "API V1"

  2. Cliquez sur "Ajouter une application"

  3. Une fenĂȘtre s'affiche

Renseignez les informations suivantes, puis cliquez sur "Valider" pour créer l'application.

Attention : Le niveau de privilĂšge de vos tokens reprend le profil de privilĂšge du collaborateur propriĂ©taire des tokens. Il est donc recommandĂ© que ce soit un administrateur qui crĂ©e l’accĂšs.

Si le compte du collaborateur venait Ă  ĂȘtre dĂ©sactivĂ© ou supprimĂ©, les tokens associĂ©s deviendraient automatiquement inutilisables. Le crĂ©ateur des accĂšs API doit donc toujours avoir un accĂšs Ă  Sellsy.

Bon à savoir : L’URL API pour une authentification en V1 est : https://apifeed.sellsy.com/0/

Vous aurez ensuite accĂšs aux tokens Ă  renseigner sur l’interface dĂ©veloppeur que vous utilisez.

N’oubliez pas de cliquer sur “GĂ©nĂ©rer un token utilisateur” pour obtenir Ă©galement les tokens Ă  ce niveau.

Bon à savoir : Vous pouvez retrouver plus d'informations sur l’authentification dans la rubrique : https://api.sellsy.fr/documentation/intro

Pour aller plus loin

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