API-nin RESTful memarlıq prinsiplərinə uyğun olub-olmadığını necə müəyyən etmək olar?

RESTful API, aşağıdakı əsas meyarlar təmin olunduqda REST prinsiplərinə uyğun sayılır:

• HTTP metodlarının məqsədəuyğun istifadəsi: GET məlumat almaq üçün, POST yaratmaq üçün, PUT/PATCH yeniləmək üçün, DELETE silmək üçün.
• Resursların URI ilə identifikasiyası: hər resurs unikal və başa düşülən URL-ə malik olmalıdır.
• Serverdə vəziyyətin olmaması (stateless): hər sorğu lazım olan bütün məlumatları içərməlidir, server müştəri vəziyyətini saxlamır.
• Standart HTTP cavab kodlarından istifadə: məsələn, 200 OK, 404 Not Found, 201 Created.
• Fərqli təqdimat formatlarının dəstəklənməsi (məsələn, JSON, XML) Accept/Content-Type başlıqları vasitəsilə.

Bunu API-nin bu prinsiplərə uyğunluğunu və HTTP-nin düzgün istifadəsini analiz edərək yoxlamaq mümkündür.

---

Nümunə:

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"}