REST API-ն HTTP պրոտոկոլում

Որպես կանոն, կայքեր ստեղծելիս տվյալներ ստանալու, ստեղծելու, փոփոխելու և ջնջելու համար օգտագործվում են միայն GET և POST մեթոդները, քանի որ դրանք լավ աջակցվում են բրաուզերների և սերվերների կողմից: Նույնը վերաբերում է նաև կայքերի կողմից տրամադրվող API-ներին: Գոյություն ունեն, սակայն, հատուկ մոտեցումներ, որոնք ստանդարտացնում են API-ն ընդհանուր հարմարության համար, ինչպես API-ի մշակողների, այնպես էլ դրա օգտագործողների համար:

Մոտեցումներից մեկը REST API-ն է (հաճախ ասում են RESTful՝ օգտագործելով այս բառը որպես ածական): Այս API-ի հիմքում ընկած է HTTP պրոտոկոլի մեթոդների լայն օգտագործումը: Այս մոտեցման մեջ GET մեթոդի օգնությամբ ստացվում են տվյալները, POST մեթոդի օգնությամբ ստեղծվում են, PUT մեթոդի օգնությամբ փոփոխվում են, իսկ DELETE մեթոդի օգնությամբ՝ ջնջվում:

Օրինակի համար դիտարկենք ինչ-որ API, որը կառավարում է օգտատերերին: Տեսնենք, թե ինչպես կտեսքավորվեն URL-ները տարբեր գործողությունների համար:

Ստանում ենք բոլոր օգտատերերին.

urlGET http://api.loc/users/

Ստանում ենք մեկ օգտատեր՝ ըստ նրա id-ի.

urlGET http://api.loc/user/1/

Ստեղծում ենք օգտատեր.

urlPOST http://api.loc/user/

Փոփոխում ենք օգտատերին ըստ նրա id-ի.

urlPUT http://api.loc/user/1/

Ջնջում ենք օգտատերին ըստ նրա id-ի.

urlDELETE http://api.loc/user/1/