--- title: "Démarrer" description: "Guide pour les clients externes afin d'accéder au portail API, créer des applications, s'abonner aux APIs et les consommer." url: "https://api-portal-suitelogi-quaext.stef.com/getting-started" image: "https://api-portal-suitelogi-quaext.stef.com/_og/d/c_Ocean.takumi,title_~RMOpbWFycmVy,description_~R3VpZGUgcG91ciBsZXMgY2xpZW50cyBleHRlcm5lcyBhZmluIGQnYWNjw6lkZXIgYXUgcG9ydGFpbCBBUEksIGNyw6llciBkZXMgYXBwbGljYXRpb25zLCBzJ2Fib25uZXIgYXV4IEFQSXMgZXQgbGVzIGNvbnNvbW1lci4,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9nZXR0aW5nLXN0YXJ0ZWQi,s_Ef35GEyXQA1RbOBp.png" --- **Developer Portal** - [APIs](https://api-portal-suitelogi-quaext.stef.com/apis) - [Démarrer](https://api-portal-suitelogi-quaext.stef.com/getting-started) - [Guides](https://api-portal-suitelogi-quaext.stef.com/guides) - [Support](https://api-portal-suitelogi-quaext.stef.com/support) **[FR](https://api-portal-suitelogi-quaext.stef.com/)**|[EN](https://api-portal-suitelogi-quaext.stef.com/en)|[ES](https://api-portal-suitelogi-quaext.stef.com/es)|[IT](https://api-portal-suitelogi-quaext.stef.com/it)|[PT](https://api-portal-suitelogi-quaext.stef.com/pt)|[NL](https://api-portal-suitelogi-quaext.stef.com/nl)|[DE](https://api-portal-suitelogi-quaext.stef.com/de) ## Démarrer avec les APIs STEF Suivez ce guide pour activer votre compte, créer votre application, vous abonner aux APIs et les appeler en toute sécurité. ## [1\. Se connecter au Portail API](#_1-se-connecter-au-portail-api) Le portail API STEF vous permet de vous abonner aux APIs STEF par le biais d'applications consommatrices personnelles, ou partagées au sein d'une équipe. - Afin d'accéder au portail, il est nécessaire de faire une demande de création d'un compte client. - Pour cela, prenez contact avec votre référent STEF IT afin qu'il s'occupe des démarches. - Vous recevrez une invitation vous permettant de créer votre compte et de vous connecter aux portails de qualification et de production STEF. Le mot de passe est à renouveler tous les 200 jours ; vous serez prévenu de ce besoin de mise à jour lors de la connexion au portail. ### [Accès aux portails API](#accès-aux-portails-api) - Production : [https://api-portal-ext.stef.com/](https://api-portal-ext.stef.com/) - Qualification : [https://api-portal-quaext.stef.com/](https://api-portal-quaext.stef.com/) Afin de pouvoir créer une application consommatrice partagée avec votre équipe, il est nécessaire de demander la création d'une équipe auprès de votre référent STEF IT. ## [2\. Créer une application](#_2-créer-une-application) Pour pouvoir consommer une API, vous devez disposer au préalable d'une application consommatrice. Sa création génère un **credential**, l'identifiant de votre application lors d'un appel. 1. Cliquez sur votre profil en haut à droite du portail 2. Cliquez sur le bouton **[Applications](https://api-portal-suitelogi-quaext.stef.com/apps)** 3. Cliquez sur le bouton **New application** 4. Renseignez le nom et la description de votre application 5. Pour partager cette application avec votre équipe, cochez **This is a team owned application** et sélectionnez l'équipe souhaitée 6. Cliquez sur le bouton **Create application** 7. Notez le credential généré lors de la création Ce credential n'apparaît qu'à la création de votre application et ne sera plus visible ensuite. Conservez-le précieusement. ## [3\. S'abonner à une API](#_3-sabonner-à-une-api) Une application consommatrice peut s'abonner à une ou plusieurs APIs en fonction de ses besoins. Utilisez le menu **APIs** pour consulter le catalogue des APIs STEF disponibles. Naviguez vers les produits qui vous intéressent afin d'afficher la documentation technique développeur, qui présente pour chaque API : - Les différentes opérations supportées - La définition des objets d'entrée et de sortie - Des exemples de code permettant de les consommer Pour s'abonner à une API : 1. Affichez le détail d'une API 2. Cliquez sur **Use this API** en haut à droite 3. Cliquez sur le bouton **Register** associé à l'application que vous souhaitez abonner L'abonnement devra ensuite être validé par STEF ; rapprochez-vous de votre référent STEF IT pour cela. Une application pouvant s'abonner à plusieurs APIs, répétez la procédure d'abonnement pour chacune des APIs que vous souhaitez utiliser. ### [Consulter et gérer vos abonnements](#consulter-et-gérer-vos-abonnements) Pour consulter les abonnements d'une application, cliquez sur votre profil en haut à gauche puis sur **Applications**, puis sur le nom de votre application. Dans l'onglet **APIs**, affiché automatiquement, retrouvez la liste de vos abonnements ainsi que leur statut. Vous pouvez également demander un abonnement à d'autres APIs directement depuis ce menu, en cliquant sur **\+ API**. ## [4\. Consommer une API](#_4-consommer-une-api) Toutes les invocations d'API STEF passent par la Gateway API STEF afin d'appliquer les règles de sécurité d'accès, d'assurer la protection des services backend du système d'information STEF et de collecter les statistiques d'invocation. Les Gateway API sont accessibles via les URL suivantes : - Production : [https://api-suitelogi-ext.stef.com](https://api-suitelogi-ext.stef.com) - Qualification : [https://api-suitelogi-quaext.stef.com](https://api-suitelogi-quaext.stef.com) Pour consommer une API et respecter les règles de sécurité d'accès, ajoutez le header HTTP `X-STEF-Client-Id` à la requête, valorisé avec le credential de votre application consommatrice. La documentation technique développeur propose, pour chaque API publiée sur la plateforme, des exemples de code permettant d'invoquer la Gateway API depuis différents langages : Shell, Python, Node.js, JavaScript, Go, Java, C# et Ruby. ### [Exemple d'invocation](#exemple-dinvocation) ```bash curl -X GET "https://api.stef.com/v1/transport/orders" \ -H "X-STEF-Client-Id: " \ -H "Content-Type: application/json" ``` En complément des exemples de code, la documentation technique développeur propose des formulaires permettant d'invoquer les APIs directement depuis le portail, en mode interactif, via le bouton **Try it!**. ## [Prochaines étapes](#prochaines-étapes) ## Catalogue des APIs [Voir les APIs →](https://api-portal-suitelogi-quaext.stef.com/apis) ## Guides techniques [Voir les guides →](https://api-portal-suitelogi-quaext.stef.com/guides) ## Instances APIM [Voir les instances →](https://api-portal-suitelogi-quaext.stef.com/getting-started/instances) #### [APIs](#apis) - [Catalogue des APIs](https://api-portal-suitelogi-quaext.stef.com/apis) - [Guide de démarrage](https://api-portal-suitelogi-quaext.stef.com/getting-started) #### [Développeurs](#développeurs) - [Documentation](https://api-portal-suitelogi-quaext.stef.com/guides) - [Bonnes pratiques](https://api-portal-suitelogi-quaext.stef.com/guides/best-practices) - [Portails](https://api-portal-suitelogi-quaext.stef.com/getting-started/instances) #### [Support](#support) - [Support technique](https://api-portal-suitelogi-quaext.stef.com/support) #### [Langues](#langues) - [Français](https://api-portal-suitelogi-quaext.stef.com/) - [English](https://api-portal-suitelogi-quaext.stef.com/en) - [Español](https://api-portal-suitelogi-quaext.stef.com/es) - [Italiano](https://api-portal-suitelogi-quaext.stef.com/it) - [Português](https://api-portal-suitelogi-quaext.stef.com/pt) - [Nederlands](https://api-portal-suitelogi-quaext.stef.com/nl) - [Deutsch](https://api-portal-suitelogi-quaext.stef.com/de) © 2026 STEF — Tous droits réservés [Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)