API Design & Documentation Generator

Design a RESTful API for [PROJECT].

Project: [WHAT THE API DOES]
Resources: [MAIN ENTITIES — E.G. USERS, PRODUCTS, ORDERS]

Authentication: [JWT / API KEY / OAUTH / NONE]

Provide:
1. **Resource Design**: Endpoints for each resource (CRUD operations)
2. **URL Structure**: RESTful URL naming conventions
3. **Request/Response**: Sample request bodies and response formats for key endpoints
4. **Error Handling**: Standard error response format and common error codes
5. **Authentication Flow**: How auth works for each endpoint
6. **Pagination**: How to handle paginated results
7. **Filtering & Sorting**: Query parameter design for filtering and sorting
8. **Rate Limiting**: Rate limit strategy and headers
9. **Versioning**: API versioning strategy (URL vs header)
10. **OpenAPI/Swagger Spec**: A starter spec document I can build on

Design a RESTful API for [PROJECT].

Project: [WHAT THE API DOES]
Resources: [MAIN ENTITIES — E.G. USERS, PRODUCTS, ORDERS]
Authentication: [JWT / API KEY / OAUTH / NONE]

Provide:
1. **Resource Design**: Endpoints for each resource (CRUD operations)
2. **URL Structure**: RESTful URL naming conventions
3. **Request/Response**: Sample request bodies and response formats for key endpoints
4. **Error Handling**: Standard error response format and common error codes
5. **Authentication Flow**: How auth works for each endpoint
6. **Pagination**: How to handle paginated results
7. **Filtering & Sorting**: Query parameter design for filtering and sorting
8. **Rate Limiting**: Rate limit strategy and headers
9. **Versioning**: API versioning strategy (URL vs header)
10. **OpenAPI/Swagger Spec**: A starter spec document I can build on