Créer un accÚs API
Pour crĂ©er un accĂšs API pour votre application, rendez-vous sur âRĂ©glagesâ puis sur âPortail DĂ©veloppeurâ.
En dĂ©butant la crĂ©ation de votre accĂšs API, vous pourrez choisir le type dâaccĂšs :
Public : pour des raisons de sĂ©curitĂ©, ce type dâaccĂšs est rĂ©servĂ© aux partenaires Sellsy.
Personnel : pour une connexion serveur Ă serveur.
Bon à savoir : Les droits du collaborateur associé et sa licence seront appliqués à l'accÚs API.
Privé : pour une connexion client à serveur.
Bon à savoir : Les droits du collaborateur se connectant et sa licence seront appliqués à l'accÚs API.
Autorisations (Scopes)
Les autorisations, autrement appelées scopes, permettent de limiter, si nécessaire, les droits de l'accÚs API.
Fonctionnement :
Si vous ne voulez aucune restriction, cochez toutes les autorisations
Si vous souhaitez limiter les actions possibles, sélectionnez uniquement les scopes nécessaires
Bon à savoir : Parmi les scopes, vous avez la possibilité d'utiliser l'API V1 via votre accÚs API V2. Vous trouverez plus d'informations à ce sujet dans l'article Utiliser l'API V1 via des accÚs API V2.
Tokens de type personnels, ce type dâaccĂšs vous permet de connecter une application externe Ă Sellsy et dâĂ©changer des informations en utilisant votre accĂšs collaborateur.
Tokens de type privĂ©s, ce type d'accĂšs vous permet de crĂ©er une application externe Ă Sellsy, les collaborateurs de votre compte Sellsy pourront se connecter Ă lâapplication avec leurs identifiants Sellsy.
Une fois votre connexion effectuée, il ne vous reste plus qu'à autoriser votre application à accéder à votre compte Sellsy.
Tokens de type publics : ce type d'accĂšs vous permet de crĂ©er une application externe Ă Sellsy, lâensemble des utilisateurs Sellsy pourront tout simplement se connecter Ă votre application avec leurs identifiants Sellsy.
Bon à savoir : Les accÚs de type Privés et Publics nécessitent une Url de redirection commençant par http ou https.
Attention : Pour des raisons de sĂ©curitĂ©, un accĂšs de type public doit ĂȘtre validĂ© par nos Ă©quipes pour justifier son utilisation. Pour cela, merci de nous envoyer un mail Ă contact@sellsy.com
Client ID et Client Secret
Pour chaque type d'accÚs, un Client ID et un Client Secret seront générés automatiquement.
Important : N'oubliez pas de les copier immédiatement aprÚs la création de l'accÚs afin de pouvoir authentifier et connecter votre application.
â
Attention : Le Client Secret ne sera affiché qu'une seule fois. Si vous le perdez, vous devrez créer un nouvel accÚs API.
Liste des accĂšs API
La liste des accĂšs API est disponible dans la rubrique "RĂ©glages", "Portail DĂ©veloppeur", "API v2".
Tester vos accĂšs API avec Postman
Pour tester vos accĂšs API, nous vous recommandons d'utiliser Postman, un outil gratuit de test d'API.
Configuration selon la version d'API :
Configuration Postman API V1 : Guide de configuration pour tester l'API V1
Configuration Postman API V2 : Guide de configuration pour tester l'API V2
Ces guides vous accompagnent pas Ă pas dans la configuration de Postman pour effectuer vos premiers appels API.