REST API HTTP protokolunda
Köpçilik web sahypalary döredilende, maglumat almak, döretmek, üýtgetmek we pozmak üçin diňe GET we POST usullary ulanylýar, sebäbi olar brauzerler we serwerler tarapyndan gowy goldanylýar. Web sahypalary tarapyndan hödürlenýän API-lere-de şol bir zat degişli. Şonda-da, ýörite ýaklaşyklar bar, olaryň API-leri standartlaşdyrmagy hem API öndürijileri, hem-de onuň ulanyjylary üçin umumy amatlylyk hökmünde.
Şol ýaklaşyklaryň biri REST API-dir (köp wagtlary "RESTful" diýip aýdylýar we bu sözi sypat söz hökmünde ulanylýar). Bu API-nyň esasynda HTTP protokolunyň usullarynyň giňden ulanylmagy ýatyr. Bu ýaklaşykda GET usuly bilen maglumatlar alynýar, POST usuly bilen döredilýär, PUT usuly bilen üýtgedilýär, we DELETE usuly bilen - pozulýar.
Mysal üçin bir API-ny gözden geçireýli, ulanyjylar bilen işleýän. Durmuşa, çärli hereketler üçin URL-leriň nähili görünjekdigine seredeli.
Ähli ulanyjylary alyş:
GET http://api.loc/users/
Bir ulanyjyny onuň id boýunça alyş:
GET http://api.loc/user/1/
Ulanyjy döretmek:
POST http://api.loc/user/
Ulanyjyny onuň id boýunça üýtgetmek:
PUT http://api.loc/user/1/
Ulanyjyny onuň id boýunça pozmak:
DELETE http://api.loc/user/1/
Internet dükanynyň önümleriniň API-si bardyr diýlip düşüň. Dükanyň URL-lerini RESTful API boljak şekilde ýazyň.