Ի՞նչ է REST API-ն։

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

Հիմնարար սկզբունքներ REST-ի:

• Stateless (պետականության բացակայություն): Սերվերը չի պահում հաճախորդի վիճակի մասին տեղեկություններ միջեւ հարցումների։ Ամեն հարցում պարունակում է անհրաժեշտ բոլոր տեղեկությունները։
• Client-Server (հաճախորդ-սերվեր): Հստակ բաժանում հաճախորդի և սերվերի միջև։ Յուրաքանչյուրն ինքնուրույն զարգանում է։
• Cacheable (կեշավորելի): Պատասխանները կարող են նշվել որպես կեշավորելի կամ ոչ կեշավորելի, ինչը բարելավում է կատարողականությունը։
• Layered System (շերտավոր համակարգ): Հաճախորդը չի կարող իմանալ, արդյոք նա անմիջապես կապված է սերվերի հետ, թե միջնորդ շերտերի միջոցով։
• Uniform Interface (համամասն ինտերֆեյս): Ստանդարտացված եղանակներ ռեսուրսների հետ փոխազդելու համար։ Ներառում է՝
  • ռեսուրսների նույնականացում (URI)
  • ռեսուրսների մանիպուլյացիա ներկայացումներով (ռեսուրսի մասին տեղեկատվությունը փոխանցվում է ներկայացումներով)
  • ինքնաբուխ հաղորդագրություններ (յուրաքանչյուր հաղորդագրություն պարունակում է բավարար տեղեկատվություն մշակման համար)
  • Hypermedia as the Engine of Application State (HATEOAS) - ծրագրի վիճակը կառավարվում է հիպերհղումներով։

Օրինակ՝ ստանդարտ HTTP մեթոդների օգտագործում:

HTTP մեթոդ	Ռեսուրսի վրա գործողություն (օրինակ՝ /users)	Նկարագրություն
GET	/users կամ /users/{id}	Օգտագործողների ցանկի կամ կոնկրետ օգտվողի ստացում։
POST	/users	Նոր օգտվողի ստեղծում։
PUT	/users/{id}	Օգտվողի տվյալների լրիվ թարմացում ըստ ID-ի։
PATCH	/users/{id}	Օգտվողի տվյալների մասնակի թարմացում ըստ ID-ի։
DELETE	/users/{id}	Օգտվողի ջնջում ըստ ID-ի։

REST API-ները օգտագործվում են տարբեր համակարգերի և ծրագրերի միջև փոխազդեցության համար, օրինակ՝ ֆրոնտենդի և բեքենդի միջև։