rest-designlisted

Design REST APIs — resource modeling, HTTP methods, status codes, pagination, and HATEOAS. Use when designing a REST endpoint, choosing HTTP methods, modeling resources, or implementing pagination.
ecoma-io/touchstone · ★ 1 · AI & Automation · score 61

Install: claude install-skill ecoma-io/touchstone

# REST Design - Resources, not actions. `/users/123` not `/getUser?id=123` - HTTP methods are semantics: GET=read, POST=create, PUT=replace, PATCH=update, DELETE=remove - Status codes are part of the contract: 200, 201, 204, 400, 401, 403, 404, 409, 429, 500 - Pagination: cursor-based > offset-based for large datasets - HATEOAS: include links to related resources in responses