Design a REST API

Design a RESTful API for the following use case. Product/feature description: [describe what the product or feature does] Target consumers: [who will call this API — mobile app, web frontend, third-party partners?] Core entities: [list the main data objects, e.g., User, Order, Product] Deliver a complete API design including: 1. Resource hierarchy and all endpoints (method + path + one-line description) 2. Request/response JSON schemas for each endpoint (use realistic field names and types) 3. Authentication mechanism (JWT, API key, OAuth2 — recommend what fits best and explain why) 4. Pagination strategy for list endpoints 5. Standard error response format with HTTP status codes (400, 401, 403, 404, 409, 422, 500) 6. Versioning strategy (URL prefix vs. header) 7. Rate limiting recommendation 8. Three potential design pitfalls to watch out for in this specific API Format the endpoint list as a Markdown table.