HTTP protokolunda REST API
Adətən saytlar yaradarkən məlumatları əldə etmək, yaratmaq, dəyişmək və silmək üçün yalnız GET və POST metodlarından istifadə olunur, çünki onlar brauzerlər və serverlər tərəfindən yaxşı dəstəklənir. Eyni şey saytlar tərəfindən təqdim olunan API-lar üçün də keçərlidir. Lakin, həm API developerları, həm də onun istifadəçiləri üçün ümumi rahatlıq təmin edən API-ni standartlaşdıran xüsusi yanaşmalar da mövcuddur.
Bu yanaşmalardan biri REST API-dir (tez-tez RESTful sözü sifət kimi işlədilir). Bu API-nin əsasında HTTP protokolunun metodlarından geniş istifadə durur. Bu yanaşmada GET metodu ilə məlumatlar əldə olunur, POST metodu ilə yaradılır, PUT metodu ilə dəyişdirilir, DELETE metodu ilə isə silinir.
Nümunə üçün, istifadəçilərlə işləyən müəyyən bir API-ni nəzərdən keçirək. Müxtəlif əməliyyatlar üçün URL-lərin necə görünəcəyinə baxaq.
Bütün istifadəçiləri əldə edirik:
GET http://api.loc/users/
Bir istifadəçini onun id ilə əldə edirik:
GET http://api.loc/user/1/
Istifadəçi yaradırıq:
POST http://api.loc/user/
Istifadəçini onun id ilə dəyişirik:
PUT http://api.loc/user/1/
Istifadəçini onun id ilə silirik:
DELETE http://api.loc/user/1/
Tutaq ki, sizin internet maqazinin məhsulları üçün API-nız var. API-ni RESTful etmək üçün maqazanın URL-lərini təsvir edin.