API Design Patterns

38 regler for REST endpoint navngivning, fejl, paginering, versionering og API-sikkerhed.

Af AsyrafHussin · AsyrafHussin/agent-skills

Testet · Virker ★ 9.6/10

API Design Patterns — 38 regler for REST endpoint navngivning, fejl, paginering, versionering og API-sikkerhed.

Hvad det gør

En kondenseret regelbog (38 regler / 7 kategorier) for RESTful API-design, der dækker ressourcenavngivning, fejlresponsform, paginering, versionering og auth. Udløses ved design eller gennemgang af endpoints, eller skrivning af fejlhåndterings-/pagineringskode, og henviser til per-regel-filer (rules/*.md) og en 7.200-linjers kompileret AGENTS.md for dybdegående analyser.

Testrapport

Kørte et reelt 'invoices API' redesign igennem den: skill'en omdannede verbum-baserede URL'er (POST /createInvoice) til egennavne, erstattede en bar fejlstreng med en struktureret konvolut (code/message/details/request_id) og tilføjede cursor-pagineringsmetadata plus HATEOAS-links, som den naive baseline aldrig havde.

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

Installation

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

Kommandoer og eksempelprompter

/api-design-patterns38 regler for REST endpoint navngivning, fejl, paginering, versionering og API-sikkerhed.

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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?

Læs hele rapporten →