REST API-ն HTTP պրոտոկոլում
Որպես կանոն, կայքեր ստեղծելիս տվյալներ ստանալու, ստեղծելու, փոփոխելու և ջնջելու համար օգտագործվում են միայն GET և POST մեթոդները, քանի որ դրանք լավ աջակցվում են բրաուզերների և սերվերների կողմից: Նույնը վերաբերում է նաև կայքերի կողմից տրամադրվող API-ներին: Գոյություն ունեն, սակայն, հատուկ մոտեցումներ, որոնք ստանդարտացնում են API-ն ընդհանուր հարմարության համար, ինչպես API-ի մշակողների, այնպես էլ դրա օգտագործողների համար:
Մոտեցումներից մեկը REST API-ն է (հաճախ ասում են RESTful՝ օգտագործելով այս բառը որպես ածական): Այս API-ի հիմքում ընկած է HTTP պրոտոկոլի մեթոդների լայն օգտագործումը: Այս մոտեցման մեջ GET մեթոդի օգնությամբ ստացվում են տվյալները, POST մեթոդի օգնությամբ ստեղծվում են, PUT մեթոդի օգնությամբ փոփոխվում են, իսկ DELETE մեթոդի օգնությամբ՝ ջնջվում:
Օրինակի համար դիտարկենք ինչ-որ API, որը կառավարում է օգտատերերին: Տեսնենք, թե ինչպես կտեսքավորվեն URL-ները տարբեր գործողությունների համար:
Ստանում ենք բոլոր օգտատերերին.
GET http://api.loc/users/
Ստանում ենք մեկ օգտատեր՝ ըստ նրա id-ի.
GET http://api.loc/user/1/
Ստեղծում ենք օգտատեր.
POST http://api.loc/user/
Փոփոխում ենք օգտատերին ըստ նրա id-ի.
PUT http://api.loc/user/1/
Ջնջում ենք օգտատերին ըստ նրա id-ի.
DELETE http://api.loc/user/1/
Ենթադրենք՝ դուք ունեք ինտերնետ խանութի ապրանքների API: Նկարագրեք խանութի URL-ները այնպես, որ API-ն դառնա RESTful: