# REST

> REST API design principles and best practices

- Skill: `ffsshhttiikk/rest` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ffsshhttiikk/rest`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ffsshhttiikk/rest/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: ffsshhttiikk (https://skillmd.com/u/ffsshhttiikk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ffsshhttiikk/rest

---

## What I do
- Design RESTful APIs
- Use proper HTTP methods
- Implement proper status codes
- Handle pagination and filtering
- Version APIs
- Secure endpoints

## When to use me
When building or consuming REST APIs.

## HTTP Methods
```
GET    /users        - List users
GET    /users/:id    - Get user
POST   /users        - Create user
PUT    /users/:id    - Update user (full)
PATCH  /users/:id    - Partial update
DELETE /users/:id    - Delete user
```

## Status Codes
```
200 OK
201 Created
204 No Content
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error
```

## Response Format
```json
{
  "data": { "id": 1, "name": "John" },
  "meta": { "total": 100, "page": 1 },
  "links": { "self": "/users/1" }
}
```