de claude-code-handbook104
Directives et modèles pour construire des API REST robustes : codes de statut HTTP corrects, réponses d'erreur RFC 7807, validation, assainissement, limitation du débit et gestion centralisée.
Cette compétence fournit une liste de contrôle concise et prête pour la production ainsi que des directives pour implémenter des API REST avec des codes de statut corrects, des charges utiles d'erreur conformes à la RFC 7807, la validation et l'assainissement des entrées, la limitation du débit (rate limiting), les identifiants de corrélation de requêtes et une gestion centralisée des erreurs. Elle inclut des exemples de code et des modèles de middleware pour standardiser le comportement de l'API.
Appliquez cette compétence lors de la création ou de la révision de routes d'API, de la construction de gestionnaires côté serveur, de l'ajout de validation et de gestion d'erreurs, ou du renforcement des points de terminaison contre les abus. Utile lors des revues de code, de la conception d'API et des vérifications de préparation à la production.
Applicable aux auteurs basés sur Claude et aux agents assistants développeurs (Claude Opus / Claude Code) et à tout agent aidant à produire du code côté serveur ou auditant des implémentations d'API.
Une compétence de directives de développement d'API REST bien écrite couvrant les codes d'état HTTP, les réponses d'erreur RFC 7807, la validation des entrées, la limitation du débit et les anti-patterns. Aucun script intégré — c'est une compétence de référence pure avec des exemples de code de qualité et des comparaisons claires entre bonnes et mauvaises pratiques.
Compétence de référence propre. Aucune préoccupation de sécurité. Bonne couverture des meilleures pratiques API avec des exemples TypeScript pratiques. L'architecture pourrait bénéficier de répertoires scripts/ ou references/ pour des exemples plus approfondis.
