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 :
Réponse rapide
API Design Principles est un skill pour maîtriser le design d'API REST et GraphQL pour construire des API évolutives et maintenables. Il couvre l'architecture ressources avec noms pas verbes et méthodes HTTP, versionnage, pagination, design erreurs, pièges, la migration REST et GraphQL, et une documentation, pour concevoir API, refactorer utilisabilité, établir standards d'équipe, ou relire spécifications avant implémentation.
Installation
Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 11 nov. 2026📌 Version épinglée : commit 46891e7Étape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que l'installation implique, puis demande-moi de confirmer avant de continuer. 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://raw.githubusercontent.com/wshobson/agents/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/backend-development/skills/api-design-principles/SKILL.md Version épinglée : installe le code au commit 46891e7e60da0e52baf1050b7b6391b64e84c6d9 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Récupère le fichier SKILL.md du skill wshobson-api-design-principles depuis le dépôt dans un dossier temporaire 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.
Enregistré dans vos installs récentes. Retrouvez-le à tout moment sur /connect.
🔒 Sécurité, provenance et ce que ça touche
Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?
Certificat de vérification
Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.
- Version épinglée
- 46891e7 · 2026-10-13
- Test d’installation en sandbox
- Installation exécutée dans notre sandbox de test · 11 nov. 2026 · Observé pendant le test d’installation: files.pythonhosted.org, pypi.org
- Identité du créateur
- Non vérifiée
- Veille d’empreinte
- Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
- Analyse du prompt d’installation
- 2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Questions
Comment installer un skill ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill 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 un skill avant de l’installer.