Si vous souhaitez commencer à explorer l'API Symplify, vous devez créer une clé API Symplify. Pour votre clé API, vous pouvez également choisir de générer un jeton qui sera utilisé lors de l'accès à l'API (au lieu de la clé API).
Créer une clé API
Pour créer votre clé API, allez dans Paramètres du compte> API Symplify, cliquez sur Créer nouveau.
Après cela, ajoutez simplement vos informations aux champs obligatoires (marqués d'un astérisque) et cliquez sur Créer.
Veuillez noter : il faut cocher la case clé Application API si vous souhaitez utiliser le jeton API pour vous connecter à Symplify à partir d'une autre application, c'est-à-dire par exemple votre application mobile. La clé d'application de l'API peut être distribuée en toute sécurité dans une application car son étendue est limitée. La clé API est plus polyvalente et peut être utilisée pour récupérer des données par un utilisateur malveillant.
Jetons d'API
Si vous souhaitez ajouter un jeton, cliquez sur Options et choisissez Générer un jeton d'API.
Votre jeton sera généré et vous pouvez agrandir la vue pour voir le jeton complet.
Vous pouvez copier le jeton dans le presse-papiers en cliquant sur le symbole de copie à droite du symbole Développer/Réduire le jeton:
Nous avons maintenant amélioré le test des jetons API avec un exemple de boucle plus approprié:
curl –H “X-Carma-Authentication-Token: thisisthesecrettoken“ \
–H “Accept: application/json” \
–H “Content-Type: application/json” \
https://ibt-proxy.carmamail.com/{server}/rest/{CUSTOMERID}/apiurl
Résultat:
{“serverBaseUrl”:”http://{server}.carmamail.com/“,”webserviceUrl”:”https://ibt-proxy.carmamail.com/{server}/carmaws“,”swaggerUrl”:”http://{server}.carmamail.com//mail/swagger“,”restUrl”:”https://ibt-proxy.carmamail.com/{server}/rest“,”controllerUrl”:”https://ibt-proxy.carmamail.com/{server}/mail“}
Voila! Vous êtes prêt avec votre nouveau API-Token!