Créez un compte sur le portail, puis rendez-vous dans Mes Applications pour créer une application. Votre Application Secret est affiché à la création — copiez-le et conservez-le en lieu sûr. Une fois l'application approuvée, vous pouvez l'utiliser dans vos appels. Consultez le guide de démarrage pour plus de détails. :::

L'environnement Sandbox (https://sandbox-api.stef.com) est dédié aux tests — pas de quota, données fictives. L'environnement Production (https://api.stef.com) utilise des données réelles avec les quotas définis dans votre plan d'accès. :::

Les tokens OAuth 2.0 expirent après 1 heure. Demandez un nouveau token via l'endpoint /oauth2/token. Nous recommandons d'implémenter un mécanisme de renouvellement automatique (refresh token). Consultez le guide d'authentification. :::

Vous avez atteint la limite de requêtes de votre plan. Vérifiez les headers X-RateLimit-Remaining et Retry-After dans la réponse et implémentez un backoff exponentiel. Consultez les bonnes pratiques pour la gestion du rate limiting. :::

Chaque API dispose d'un mode Try it dans sa page de documentation sur ce portail. Vous pouvez aussi exporter la spécification OpenAPI et l'importer dans Insomnia ou Postman via le bouton dédié. :::