API Design Patterns

38 regole per la denominazione degli endpoint REST, errori, paginazione, versioning e sicurezza API.

di AsyrafHussin · AsyrafHussin/agent-skills

Promosso ★ 9.6/10

API Design Patterns — 38 regole per la denominazione degli endpoint REST, errori, paginazione, versioning e sicurezza API.

Cosa fa

Un manuale di regole condensato (38 regole / 7 categorie) per la progettazione di API RESTful, che copre la denominazione delle risorse, la forma della risposta agli errori, la paginazione, il versioning e l'autenticazione. Si attiva durante la progettazione o la revisione di endpoint, o la scrittura di codice per la gestione degli errori/paginazione, e rimanda a file per regola (rules/*.md) e a un AGENTS.md compilato di 7.200 righe per approfondimenti.

Rapporto di test

Ho eseguito una vera riprogettazione di una 'API per fatture': lo skill ha trasformato URL basati su verbi (POST /createInvoice) in nomi propri, ha sostituito una semplice stringa di errore con un envelope strutturato (code/message/details/request_id) e ha aggiunto metadati di paginazione basati su cursore più link HATEOAS che la baseline ingenua non aveva mai avuto.

Testato il: 2026-07-14 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/AsyrafHussin/agent-skills
cd agent-skills
mkdir -p ~/.claude/skills
cp -r skills/api-design-patterns ~/.claude/skills/api-design-patterns

Comandi e prompt di esempio

/api-design-patterns38 regole per la denominazione degli endpoint REST, errori, paginazione, versioning e sicurezza API.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Design a REST API for user management with proper error handling
Review my API endpoints for best practices before we ship
What HTTP status codes should I use for this validation error?

Rapporto completo →