Versioning and resource structure

API versioning strategy

Use URL-based versioning. Examples:

Why:

Explicit versioning in every request
Easier debugging, monitoring, and routing
Cleaner folder structure
Old versions can coexist safely

Resource structure and folder organization

Use RESTful, hierarchical naming to reflect relationships. Example:

GET /users/{user_uuid}/addresses

Guidelines:

Plural nouns only (/users, /addresses)
Keep nesting shallow (2 levels max)
Actions are defined by HTTP verbs, not URLs

Pagination, filtering, and sortingHow to paginate, sort, and filter collections consistently.

Versioning and resource structure
API versioning strategy
Resource structure and folder organization