REST API design patterns
Concevoir des API REST cohérentes — nommage des ressources, codes de statut, pagination, enveloppes d'erreur, versionnement, limites de débit
- Quoi
- Concevoir des API REST cohérentes — nommage des ressources, codes de statut, pagination, enveloppes d'erreur, versionnement, limites de débit
- Coût
- Gratuit
- Prérequis
- un projet d'API REST (nouveau ou existant) ; rien d'autre — le skill est un guide plus des patterns de code, aucun compte ni clé requis
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — le guide de conception d'API REST de @affaan-m : nommage des ressources au pluriel en kebab-case avec conventions d'URL (y compris les contre-exemples — verbes dans les URLs, noms au singulier, snake_case), sémantique des méthodes HTTP avec tableau d'idempotence, référence des codes de statut qui mappe les vraies pannes aux bons codes (400/401/403/404/409/422/429, jamais « 200 pour tout »), enveloppes standardisées de réponses de succès et d'erreur (data/meta/links, détails de validation par champ), pagination par offset vs curseur avec guide de choix, patterns de filtrage/tri/recherche, exemples d'auth par jeton et d'autorisation par ressource vs par rôle, en-têtes de rate limiting et conception des paliers, stratégie de versionnement par chemin d'URL (maximum deux versions actives, dépréciation avec 6 mois de préavis et en-têtes Sunset), plus des patterns d'implémentation prêts à adapter en TypeScript (Next.js + Zod), Python (Django REST Framework) et Go (net/http), et une checklist avant livraison. Licence MIT. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : un projet d'API REST (nouveau ou existant) ; rien d'autre — le skill est un guide plus des patterns de code, aucun compte ni clé requis Installe-moi « Patterns de conception d'API REST ». Il enseigne à un agent les conventions de @affaan-m pour des API REST cohérentes : nommage des ressources au pluriel en kebab-case, sémantique des méthodes HTTP, référence des codes de statut (fini le « 200 pour tout »), enveloppes standardisées de succès/erreur avec détails de validation par champ, pagination offset vs curseur, filtrage/tri/recherche, auth par jeton et patterns d'autorisation, rate limiting, versionnement par URL avec stratégie de dépréciation, plus des patterns d'implémentation en TypeScript, Python et Go et une checklist avant livraison. Licence MIT. Dépôt : https://github.com/affaan-m/ecc/blob/main/.agents/skills/api-design/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « api-design ». 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 (p. ex. rien — c'est une référence de conception ; pointez l'agent vers votre API pour revoir ou concevoir des endpoints). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. 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.