API Design Guide

Design Principles

1. Consistency - Same patterns everywhere
2. Predictability - Clients can guess behavior
3. Simplicity - Easy to use correctly, hard to misuse
4. Evolvability - Can change without breaking clients

REST API Design

URL Structure

/resources                    # Collection
/resources/{id}               # Single resource
/resources/{id}/sub-resources # Nested resources