Rest patterns

Skill aiskillstore/marketplace/skills/0xdarkmatter/rest-patterns

Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

Install

npx -y skills add aiskillstore/marketplace --skill rest-patterns

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

What its author says it does

Copied from the file, not written here

Quick reference for RESTful API design patterns, HTTP semantics, caching, and rate limiting. Triggers on: rest api, http methods, status codes, api design, endpoint design, api versioning, rate limiting, caching headers.

SKILL.md

2.9 KB, as published. Nobody here has run it

REST Patterns

Quick reference for RESTful API design patterns and HTTP semantics.

HTTP Methods

Method	Purpose	Idempotent	Cacheable
GET	Retrieve resource(s)	Yes	Yes
POST	Create new resource	No	No
PUT	Replace entire resource	Yes	No
PATCH	Partial update	Maybe	No
DELETE	Remove resource	Yes	No

Essential Status Codes

Code	Name	Use
200	OK	Success with body
201	Created	POST success (add `Location` header)
204	No Content	Success, no body
400	Bad Request	Invalid syntax
401	Unauthorized	Not authenticated
403	Forbidden	Not authorized
404	Not Found	Resource doesn't exist
422	Unprocessable	Validation error
429	Too Many Requests	Rate limited
500	Server Error	Internal failure

Resource Design

GET    /users              # List
POST   /users              # Create
GET    /users/{id}         # Get one
PUT    /users/{id}         # Replace
PATCH  /users/{id}         # Update
DELETE /users/{id}         # Delete

# Query parameters
GET /users?page=2&limit=20          # Pagination
GET /users?sort=created_at:desc     # Sorting
GET /users?role=admin               # Filtering

Security Checklist

Common Mistakes

Mistake	Fix
Verbs in URLs	`/getUsers` → `/users`
Deep nesting	Flatten or use query params
200 for errors	Use proper 4xx/5xx
No pagination	Always paginate collections
Missing rate limits	Protect against abuse

Quick Reference

Task	Pattern
Paginate	`?page=2&limit=20`
Sort	`?sort=field:asc`
Filter	`?status=active`
Sparse fields	`?fields=id,name`
Include related	`?include=orders`

When to Use

Designing new API endpoints
Choosing HTTP methods and status codes
Implementing caching headers
Setting up rate limiting
Structuring error responses

Additional Resources

For detailed patterns, load:

./references/status-codes.md - Complete status code reference with examples
./references/caching-patterns.md - Cache-Control, ETag, CDN patterns
./references/rate-limiting.md - Rate limiting strategies and headers
./references/response-formats.md - Errors, versioning, bulk ops, HATEOAS