Πώς να προσδιορίσετε αν ένα API πληροί τις αρχές της RESTful αρχιτεκτονικής;

Ένα RESTful API συμμορφώνεται με τις αρχές REST εάν πληρούνται τα ακόλουθα βασικά κριτήρια:

• Κατάλληλη χρήση των μεθόδων HTTP: GET για λήψη δεδομένων, POST για δημιουργία, PUT/PATCH για ενημέρωση, DELETE για διαγραφή.
• Ταυτοποίηση πόρων μέσω URI: κάθε πόρος έχει μια μοναδική και κατανοητή URL.
• Απουσία κατάστασης στον διακομιστή (stateless): κάθε αίτημα περιέχει όλες τις απαραίτητες πληροφορίες, ο διακομιστής δεν διατηρεί κατάσταση πελάτη.
• Χρήση τυπικών κωδικών απάντησης HTTP: π.χ., 200 OK, 404 Not Found, 201 Created.
• Υποστήριξη διαφόρων μορφών παρουσίασης (π.χ., JSON, XML) μέσω των επικεφαλίδων Accept/Content-Type.

Αυτό μπορεί να ελεγχθεί αναλύοντας το API για συμμόρφωση με αυτές τις αρχές και σωστή χρήση του HTTP.

---

Παράδειγμα:

GET /users/123 HTTP/1.1
Host: example.com
Accept: application/json

HTTP/1.1 200 OK
Content-Type: application/json

{"id":123, "name":"Ivan"}