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 —тер ар кандай системалар жана колдонмолор ортосунда өз ара аракеттенүү үчүн колдонулат, мисалы, фронтенд жана бэкенд арасында.