REST API эмне?

REST API — бул бөлүштүрүлгөн системдерди куруу үчүн архитектуралык стиль. RESTтин негизги принциптери:

Statelessness: Клиенттен серверге келген ар бир суроо толук маалыматты камтышы керек. Сервер кардардын абалын суроолор ортосунда сактабайт.
Client-Server: Клиент жана сервер ортосунда так милдеттер бөлүнүшү керек. Клиент суроолорду жиберет, сервер аларды иштетет.
Cacheable: Сервер жоопторду кэштөө мүмкүнчүлүгүн көрсөтүшү керек.
Layered System: Клиент түздөн-түз акыркы сервер менен иштешпей, аралык катмарлар аркылуу иштеше алат (прокси, жүктү теңдештирүүчү).
Uniform Interface: Клиент жана сервер ортосунда бирдиктүү жана стандартташтырылган өз ара аракеттешүү ыкмасы. Бул принцип төмөнкүлөрдү камтыйт:
- Identification of Resources: Ресурстар (маалыматтар) URL аркылуу аныкталат.
- Manipulation of Resources Through Representations: Клиент ресурстар менен өз ара аракеттешет, алардын өкүлчүлүктөрүн (мисалы, JSON, XML) алат жана өзгөртүү үчүн жаңы өкүлчүлүктөрдү жиберет.
- Self-descriptive Messages: Ар бир билдирүү өзү тууралуу жетиштүү маалымат камтыйт, аны иштетүүнү түшүнүү үчүн.
- HATEOAS (Hypertext As The Engine Of Application State): Ресурстар байланышкан ресурстарга жана жеткиликтүү аракеттерге шилтемелерди (гиперссылкаларды) камтышы керек.

REST API адатта ресурстар үстүндө операцияларды аткаруу үчүн стандарттуу HTTP ыкмаларын колдонуп:

GET: Ресурсты же ресурстардын топтомун алуу.
POST: Жаңы ресурсты түзүү.
PUT: Бар ресурсту толук жаңылоо.
PATCH: Бар ресурстун бөлүктүү жаңылануусу.
DELETE: Ресурсты өчүрүү.

Ресурс жөнүндө JSON мисалы:

{
  "id": 1, // Идентификатор
  "name": "Resource Name", // Ресурстун аты
  "description": "Detailed description of the resource." // Ресурстун сүрөттөөсү
}

REST APIнин тестирлөөдө төмөнкүдөй текшерүүлөр кирет:

Функционалдуулук (суроолорго жооптордун тууралыгы)
каталардын иштетилиши
өндүрүмдүүлүк
коопсуздук
документацияга ылайыктык.