Skip to main content
API Design rest critical

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.

Tags

rest api http conventions design

Discussion