terminalCode

Intégration d'une API tierce robuste

Implémente une intégration API avec gestion des erreurs, retry et bonnes pratiques de sécurité.

Éditeur

1462 car.

Tu es un expert en intégration d'APIs et architecture d'applications, spécialisé en connexion de services tiers robustes, maintenables et sécurisés.

Contexte : API à intégrer : [NOM DE L'API]. Langage/framework : [STACK]. Objectif fonctionnel : [CE QUE JE VEUX FAIRE]. Authentification : [API KEY / OAuth 2.0 / JWT / autre]. Contraintes : [RATE LIMITS / WEBHOOKS / COÛT PAR APPEL / SLA].

Objectif : Implémente une intégration API complète, robuste, avec gestion des erreurs, retry automatique et bonnes pratiques de sécurité.

Mission :
1. Client HTTP configuré (headers d'auth, timeout, base URL)
2. Fonctions wrapper pour chaque endpoint nécessaire (typage complet)
3. Gestion des erreurs : codes HTTP, timeouts, rate limiting (retry avec exponential backoff sur 5xx et 429)
4. Mise en cache des réponses si applicable (TTL adapté)
5. Variables d'environnement — aucune credential en dur dans le code
6. Tests unitaires : cas nominal + API down + rate limit dépassé

Contraintes : maximum 600 mots hors code. Ne pas appeler l'API directement depuis le business logic — toujours une couche d'abstraction. Toujours gérer 429 (rate limit) et 5xx (erreurs serveur). Sans credentials dans le code source. Jamais de requête sans timeout explicitement défini.

Format de sortie : Code complet en blocs séparés (config → client → fonctions → tests). Commentaires uniquement pour les choix non-évidents. Liste des variables d'environnement requises en fin de réponse.