Conception de passerelle API

Ce qu'elle fait

Cette compétence fournit une conception et une gouvernance d'API de niveau professionnel. Elle garantit que les API sont traitées comme des contrats, en se concentrant sur la compatibilité ascendante, la sécurité et la lisibilité machine. Elle génère des spécifications OpenAPI 3.1/3.2 et des SDL GraphQL complets.

Quand l'utiliser

Activez cette compétence pour la conception de ressources REST ou GraphQL, la génération de spécifications OpenAPI, la planification de stratégies de versionnage ou de dépréciation d'API, ou la réalisation d'audits de sécurité basés sur le Top 10 de l'OWASP API Security. Elle est également essentielle pour concevoir des API « prêtes pour les agents » (llms.txt).

Ce qui est inclus

• Références : Une suite complète de guides couvrant la sémantique REST, la conception GraphQL, les fournisseurs de Webhooks, les modèles d'authentification API et la limitation du débit (Rate Limiting).
• Instructions : Un flux de travail structuré SURVEY → DESIGN → VALIDATE → PRESENT avec des « Recettes » spécifiques pour différentes tâches d'API (par exemple, breaking pour la détection de changements, auth pour la sécurité).

Agents compatibles

Optimisée pour les agents capables de produire des spécifications YAML/JSON structurées et de la documentation architecturale, tels qu'OpenClaw et les modèles de classe Opus.