de agent-skills-standard488
Conventions de conception d'API REST d'opinion : verbes HTTP, codes d'état, modèles d'URL, versionnage, pagination et exigences OpenAPI pour des API fiables et versionnées.
Fournit un ensemble concis de normes de conception d'API REST et d'anti-modèles pour les équipes construisant des API HTTP. Il couvre l'utilisation correcte des verbes HTTP, les codes d'état, la conception d'URL, les stratégies de versionnage, les meilleures pratiques de pagination, les attentes du contrat OpenAPI et les en-têtes de sécurité de base.
Utilisez cette compétence lors de la conception ou de la révision de points de terminaison REST, de la préparation de spécifications OpenAPI, de l'implémentation de la pagination, du choix d'une approche de versionnage ou de l'audit de la sécurité des API et de la sémantique des réponses. Particulièrement utile lors des révisions de PR et de la rédaction de contrats d'API.
{}
Une compétence de référence bien organisée sur la conception d'API REST couvrant les verbes HTTP, les codes de statut, les conventions d'URL, le versionnage, la pagination et les contrats OpenAPI. Aucun script inclus — purement une compétence de documentation/liste de vérification. Les déclencheurs du frontmatter sont spécifiques et bien conçus. La section sur les anti-patterns apporte une valeur pratique.
Compétence propre sans préoccupations de sécurité. Pure documentation/référence. Bénéficierait d'un répertoire references/ avec des exemples de spécifications OpenAPI ou des modèles de réponses d'erreur comme mentionné dans SKILL.md.
