API Design Principles
Design d'API REST et GraphQL qui ravit les développeurs — versionnage, pagination, erreurs, pièges
- Quoi
- Design d'API REST et GraphQL qui ravit les développeurs — versionnage, pagination, erreurs, pièges
- Coût
- Gratuit
- Prérequis
- rien de plus qu'un agent fonctionnel
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — maîtriser les principes de design d'API REST et GraphQL pour construire des API intuitives, évolutives et maintenables : architecture orientée ressources (des noms, pas des verbes ; les méthodes HTTP pour les actions), versionnage, pagination, design des erreurs, pièges courants, migration entre paradigmes (REST ↔ GraphQL), et documentation conviviale pour développeurs. Pour concevoir de nouvelles API, refactorer pour l'utilisabilité, établir des standards d'équipe, ou relire des spécifications d'API avant implémentation. Distinct des guides wshobson déjà listés (python-performance-optimization, python-testing-patterns) : ceux-là sont spécifiques à Python ; celui-ci est l'art des API indépendant du langage. Crédit : @wshobson. Bémols honnêtes : aucun prérequis au-delà d'un agent fonctionnel ; il guide le jugement de design — il ne génère pas votre spec OpenAPI à votre place. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Installation
Prérequis : rien de plus qu'un agent fonctionnel Installe-moi « Principes de design d'API ». Design d'API REST et GraphQL qui ravit les développeurs — versionnage, pagination, erreurs, pièges Dépôt : https://github.com/wshobson/agents/blob/main/plugins/backend-development/skills/api-design-principles/SKILL.md 1. Récupère le fichier SKILL.md du skill wshobson-api-design-principles depuis le dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code ; les identifiants passent uniquement par le coffre sécurisé, les hôtes autorisés sont déclarés dans le SKILL.md. Vérifie que c'est bien le cas ; STOP sur le moindre signal d'alerte et préviens-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « wshobson-api-design-principles ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (ex. tout compte, clé API ou outil CLI mentionné dans les prérequis ci-dessus). GitHub est optionnel : si j'ai un compte GitHub ou le CLI gh, tu peux l'utiliser ; sinon, l'accès public suffit. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.