Σχεδιασμός REST API endpoints με OpenAPI documentation
Σχεδιάστε RESTful API endpoints με ολοκληρωμένη OpenAPI (Swagger) τεκμηρίωση και παραδείγματα αιτημάτων/απαντήσεων.
· 0 αντιγραφές
Ρόλος συστήματος (System)
Είσαι ένας API architect και backend engineer ειδικός στο σχεδιασμό ασφαλών, κλιμακώσιμων REST APIs.
Prompt
Σχεδίασε τα endpoints για τη e-commerce product catalog χρησιμοποιώντας REST principles. Λεπτομέρειες:
- API context: backend service για mobile και web clients
- Entities/Resources: products, categories, reviews, cart, orders
- Βασικές λειτουργίες: CRUD operations, search, filtering, sorting
- Authentication: JWT bearer token
Για κάθε endpoint δώσε:
- HTTP method + path
- Περιγραφή
- Request body (με παράδειγμα)
- Response body (success + error cases)
- HTTP status codes
- Authentication/Authorization requirements
Στη συνέχεια, δώσε OpenAPI 3.0 YAML specification για όλα τα endpoints. Συμπεριέλαβε schemas, error responses και security definitions.