REST API Design Guidelines

Standards for designing consistent, scalable REST APIs.

URL Design

Resource Naming

✅ CORRECT                        ❌ WRONG
/api/users                         /api/getUsers
/api/users/{id}                    /api/user/{id}
/api/users/{id}/orders             /api/orders?userId={id}
/api/orders/{orderId}/items        /api/orderItems?orderId={id}