API Integration Patterns

Ce que cela fait

API Integration Patterns fournit des modèles robustes et sécurisés pour intégrer des API externes et des outils CLI dans les flux de travail des agents. Cela couvre la sécurité de l'exécution des sous-processus, l'utilisation de la CLI GitHub, les stratégies de retry/backoff, les meilleures pratiques d'authentification et des aides simples pour la limitation du débit (rate-limiting). Le contenu s'adresse aux auteurs de bibliothèques et aux intégrateurs d'agents afin de réduire les erreurs courantes et les risques de sécurité.

Quand l'utiliser

• Lors de l'implémentation d'appels d'API externes ou de l'exécution d'outils CLI depuis un agent
• Lorsque vous avez besoin d'une exécution sécurisée de sous-processus (pour empêcher l'injection de commandes)
• Pour ajouter des tentatives de reconnexion et un backoff en cas d'échecs transitoires
• Pour gérer les identifiants et les jetons de manière sécurisée
• Pour gérer les limites de débit afin d'éviter l'épuisement des quotas

Ce qui est inclus

• Scripts : aucun dans le répertoire de la compétence, mais le dépôt contient des templates et des exemples (templates/, examples/)
• Références : modèles de style documentation et extraits de code d'exemple intégrés dans le corps de la compétence
• Instructions : modèles de code concrets pour les appels de sous-processus sécurisés, wrappers CLI gh, helper retry_with_backoff, modèle get_github_token et une classe RateLimiter simple.

Agents compatibles

• Idéal pour les agents qui exécutent des commandes externes ou interagissent avec des API cloud (Claude Code, assistants style Copilot/Codex, tout agent avec accès subprocess/gh CLI). Les modèles sont agnostiques au langage mais illustrés en Python et en shell pour une utilisation immédiate.