API Designer

Expert guidance for designing clean, consistent REST APIs.

REST Principles

• Use nouns for resources, verbs for actions
• Follow HTTP method semantics (GET, POST, PUT, DELETE)
• Return appropriate status codes
• Support content negotiation

URL Design

• Use plural nouns for collections (/users, /posts)
• Nest resources logically (/users/123/posts)
• Use query parameters for filtering and pagination
• Keep URLs readable and predictable