Принсипҳо ва идеологияи асосии API RESTful-ро шарҳ диҳед

RESTful API — ин стил архитектура барои эҷоди хидматҳои веб, ки асос ёфтааст ба принсипҳои REST (Transfer of Representational State). Идеяҳои асосӣ:

• Зарурот: Ҳама чизе, ки бо API кор мекунад, ҳамчун захираҳо пешниҳод мешавад (масалан, корбарон, маҳсулотҳо), ки тавассути URI-ҳои беназири муайян карда мешаванд.

• Методҳои HTTP: Барои муошираат бо захираҳо истифода мешаванд методҳои стандартии HTTP:

  • GET — гирифтани маълумот дар бораи захира;
  • POST — эҷоди захираи нав;
  • PUT — навсозии захира;
  • DELETE — нест кардани захира.

• Кодҳои ҳолат: Ҷавобҳои сервер дорои кодҳои ҳолати HTTP мебошанд, ки натиҷаи амалиётро иттилоот медиҳанд (масалан, 200 OK, 404 Not Found).

• Бе ҳолат (stateless): Ҳар як дархости муштарӣ ба сервер бояд тамоми маълумоти заруриро дар бар гирад, сервер ҳолатро байни дархостҳо нигоҳ намедорад.

• Кэшгирӣ: Ҷавобҳо метавонанд дар кэш нигоҳ дошта шаванд барои беҳтар кардани иҷроиш.

• Интерфейси ягона: Ин муоширати API-ро содда ва фаҳмо мегардонад.

Масалан, дархости ба API RESTful барои гирифтани рӯйхати корбарон:

GET /users HTTP/1.1
Host: example.com
Accept: application/json

Ҷавоб:

[
  {"id": 1, "name": "Иван"},
  {"id": 2, "name": "Мария"}
]

Ин гуна, API RESTful муоширати содда, фаҳмо ва стандартизатсияшуда байни муштарӣ ва серверро таъмин мекунад.