REST API Conventions
REST API design conventions covering resource naming, HTTP methods, status codes, and URL structure for consistent, intuitive APIs.
- Difficulty
- beginner
- Read time
- 1 min read
- Version
- v1.0.0
- Confidence
- established
- Last updated
Quick Reference
REST API: Use plural nouns for resources (/users, /orders). HTTP methods are verbs (GET=read, POST=create, PUT=replace, PATCH=update, DELETE=remove). Use hyphens in URLs, not underscores. Nest max 2 levels deep. Return proper status codes (201 Created, 204 No Content, 404 Not Found).
Use When
- Designing REST APIs
- Naming API endpoints
- Choosing HTTP methods
- Selecting status codes
Skip When
- GraphQL or gRPC APIs
- Internal RPC-style services
REST API Conventions
REST API design conventions covering resource naming, HTTP methods, status codes, and URL structure for consistent, intuitive APIs.