REST API дегеніміз не?

REST API — бұл архитектуралық стиль, стандарт емес, тарату жүйелерін құру үшін. Ол statelessness, клиент-серверлік архитектура және ресурстармен операциялар үшін стандартты HTTP әдістерін (GET, POST, PUT, DELETE, PATCH) пайдалану сияқты принциптерге негізделген.

REST негізгі принциптері:

• Stateless (күйсіздік): Сервер клиенттің күйі туралы ақпаратты сақтамайды. Әр сұрау оның өңделуі үшін қажетті барлық ақпаратты қамтиды.
• Client-Server (клиент-сервер): Клиент пен сервердің нақты бөлінуі. Әрқайсысы тәуелсіз дамуы мүмкін.
• Cacheable (кэштеуге болатын): Жауаптар кэштеуге болатын немесе болмайтын деп белгіленуі мүмкін, бұл өнімділікті арттырады.
• Layered System (қабатталған жүйе): Клиент серверге тікелей қосылғанын немесе аралық қабаттар арқылы қосылғанын білмейді.
• Uniform Interface (біркелкі интерфейс): Ресурстармен өзара әрекеттесу үшін стандартталған тәсілдер. Оларға:
  • Ресурстарды идентификациялау (URI)
  • Ресурстарды көрсету арқылы манипуляциялау (ресурс туралы ақпарат representations-да беріледі)
  • Өздігінен сипатталатын хабарламалар (әр хабарлама өңдеу үшін жеткілікті ақпаратты қамтиды)
  • 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 түрлі жүйелер мен қосымшалар арасында өзара әрекеттесу үшін пайдаланылады, мысалы, фронтенд пен бэкенд арасында.