??? ????? REST API ? ??? ?? ????????

/in /by

??? ????? REST API ? ??? ?? ????????

REST API ?????? ????? ????????????? ????? ??? ???????????? ???-????????, ??????????? ?????????? ?????????? ??????????? ????? ????????. ?????????? REST ???????????????? ??? Representational State Transfer. API ????????? ????????????? ????? ?????????????? ??????????? ??????????. REST API ?????????? ???????? HTTP-????????? ??? ?????????? ?????????? ????? ???????? ? ????????. ?????? ???????? ?????? ?? ??????, ????????? ?????? ?????? ? ????????. ?????? ????????? ?????? ?????? ???? ? ????????????? ????? ? ????????????????? ????, ???? ????? ? JSON ??? XML.

????? ????????? API ? ??? ?????????? ????? ???????

API ???????????? ?????????????? ????? ??????????? ????????? ??? ????? ????? ?? ?????????? ?????????. ???????????? ????????? API ??? ??????????? ????????? ?????, ??????? ????? ? ???????. ????????? ?????????? ?????? ???????? ???????? ?? ????????????????? ??????????? ????? API, ? ?? ?????????? ???? ???? ????????????.

???????? ?????????? ????? API ??????????? ?? ????? ??????-?????. ?????????? ????????? ????????? ?????? ? ??????? ? ????????????? ??????? ? ????????. ?????? ???????????? ?? ?????? ?? ??????????? ??????, ??????????? ???????? ??????. ?????? ???????? ??????, ???????????? ????? ??????? ? ????????? ????????.

????? ?????????? ?????? ?????????? ????? ? ?????????? ?????????? ??? ?????????? ? ?????????? ????????. ????? ??????????????? ??????? ? ?????????????? ????. ?????????? ?????????? ??????????? ???????? ???????? ??? ?????? ???????? ????????????.

API ???????????? ????????????? ????????? ???????, ??? ?????? ?????? ????????? ????????????? ???????????. ???????? ??????????? ?????? ???? ????????? ??????????, ???????? ? ???????????? ??????????? ?????. ???????? ????????????? ?????????????? ???????? ??????? ??? ??????????? ?? ?????? ????????.

??? ????? REST ? ??? ??????????????? ????????

REST ???????? ????????????? ????????, ???????????? ???????????? ??????????? ? ?????? ??? ?????????? ??????????? ???-????????. ??? ??????? ?????? ????????? REST ? ????? ??????????? ? 2000 ????. ????????? REST ???????????? ?? ????????????? ????????? ?????????? ? ?????????? ?????????, ?????? ????? HTTP.

REST ?????? ??????? ??? ??????? ?????????? ???????. ?????? ?????? ???????? ???????????? ????????????? ? ??????? URL. ??????? ??????????????? ? ????????? ????? ??????????? ????????, ?? ????????? ?? ?????????? ?????????? ???????. ?????? ?????? ???????????? ??????????????? ?????????? ? ???????? ????????? ?????? ????????.

??????????????? ???????? REST ???????? ????????????? ??????:

  • ???????????? ?????????? — ??????????????????? ?????? ???????????? ? ????????? ????? HTTP-??????
  • ??????-????????? ????????? — ?????????? ??????????????? ????? ???????? ? ????????
  • ?????????? ????????? — ?????? ?????? ???????? ??? ?????? ???????? ??? ?????????
  • ??????????? — ????? ???????? ??????? ??? ????????? ??????????????
  • ???????? ??????? — ????????? ????? ????????? ?????????????? ???? ??? ??????????? ?? ???????

?????????? ?????? REST ???? ??????? ????????, ??????????? ? ????? ?????????????? ???-??????? ??? ????????????? ??????????.

??????-????????? ??????????? ? ????????????? ??????

??????-????????? ??????????? ????? ??????? ?? ??? ?????????? ???????? ? ??????? ????????. ?????? ???????????? ?? ???????????????? ????????? ? ????????????? ??????????. ?????? ????????? ??????????? ??????????, ??????-??????? ? ?????????? ????????. ???????? ????????????? ?????? ?????? ???????????? ????????????? ?????????? ?????????.

?????????? ??????? ???????????? ?? ???????????? ? ?????????????. ????????? ??????????? ??????????, ????????? ??????? ? ??????? ??????????. ?????? ????? ???? ???-?????????, ????????? ??????????? ??? ?????????? ???????????. ????????? ??????? ???????? ? ?????? ???????? ????? ????? API.

????????? ??????? ???????????? ?? ?????????? ??????-?????? ? ???????? ??????????. ?????? ????????? ????? ???????, ???????????? ???????, ??????????????? ? ?????? ?????? ? ????????? ??????. ??????????? ???????? ?????? ???????? ?????????? ?????? ? ??????????? ??????????????? ????????.

????????????? ??????????????? ???????? ???????? ???????. ???????????? ???????????? ????????? ??? ??????????? ????????? ??????. ?????????? ????????? ????? ?? ??????? ?????? ?? ???? ?????????? ??????????. ?????? ????? ????????? ???????? ? ????????? ??????????? ???????????.

??????? stateless ? ?????????? ?????????? ?????????

??????? stateless ?????????????, ??? ?????? ?? ?????? ???????? ? ?????????????? ???????? ???????. ?????? ?????? ???????? ??? ????????? ?????????? ??? ??????????. ?????? ?? ?????????? ???????? ?? ??????? ?????????????? ??? ???????????? ??????. ???????? ????? ???????? ?????? ?????? ????????? ? ???????? ??????????.

?????????? ????????? ?? ??????? ????????? ???????? ?? ?????? ? ?????????. ??????? ?? ?????????? ????????????? ??????? ??? ???????? ?????? ????????. ??????? ????? ??????????????, ??????? ????? ??????? ??? ???????????? ?????????. ????? ?????? ? ???????? ???????????? ?????? ?? ??????? ???????.

?????? ????????? ?????????? ??????????. ?????? ?????? ???????? ?????? ??????????????, ?????????????? ?????? ? ??????????? ??????. ?????????? ?????????? ????????? ?????? ? ?????????? ????????? ???????????? ? ???????? ?? ??? ?????????????. ????????????? ??????????????? ??????? ??????? ?????????? ? ???????.

Stateless-??????????? ???????? ??????? ? ????????. ?????????? drgn ????????? ?????? ?????? ????????? ?? ??????? ????????????. ?????????????? ????? ??????? ?????????????? ???????, ????????? ??????? ?? ????????? ??????????????? ??????????? ?????????.

HTTP-??????: GET, POST, PUT, DELETE

HTTP-?????? ????????????? ??? ????????, ??????? ?????? ????????? ? ???????? ?? ???????. REST API ??????????? ??????????? ?????? ????????? HTTP ??? ????????, ??????, ?????????? ? ???????? ??????. ?????? ????? ????? ????????????? ?????????? ? ?????????.

????? GET ??????? ??? ?????????? ?????? ? ???????. ?????? GET ?? ???????????? ????????? ??????? ? ????????? ??????????. ?????? ??????????? GET ??? ?????? ???????? ? ?????????????, ??????? ??? ?????? ????????. ????????? ?????? ???? ???????????? ? URL-?????? ????? ????? ???????.

????? POST ????????? ????? ?????? ?? ???????. ?????? ???????? ???????? ? ?????????? ???????, ? ?????? ???????????? ?????? ? ?????????? ???????. POST ??????????? ??? ??????????? ?????????????, ???????? ????????? ? ??????? ??? ?????????? ????????????.

????? PUT ????????????? ????????? ?????? ?????????. ?????? ?????????? ????? ????? ?????????? ??? ??????? ??????????? ?????????. PUT ????????????? ??? ?????????????? ??????? ???????????? ??? ????????????? ????????????. ???? ?????? drgn ?? ???????, PUT ????? ???????????? ????? ????????.

????? DELETE ??????? ?????? ? ???????. ?????? ????????? ????????????? ???????? ??? ????????.

????????? ???????: URL, ????????? ? ????

HTTP-?????? ? REST API ??????????? ?? ?????????? ???????????, ?????? ?? ??????? ????????? ?????????? ????. ?????????? ????????? ??????? ??????????? ?????????? ?????????? ?? ??????? ??????? ? ????????? ?????????? ??????????.

URL-????? ????????????? ???????????? ??????? ?? ???????. ????? ???????? ????????, ???????? ???, ???? ? ??????? ? ?????????????? ????????? ???????. ???? ??? ??????? ???????? ???????????? ????????? ? ????????????? ????????????? ????????. ????????? ??????? ?????? ?????? ?????? ?????????? ???????? ?????????? ??? ?????????? ????????.

?????? ??????? ???????? ?????????? ? ???????????? ????????. ???????? ????????? ???????? ????????????? ?????:

  • Content-Type — ?????????? ?????? ?????????? ? ?????????? ???????, ???????? application/json
  • Authorization — ???????? ????? ??? ??????????????? ???????? ??? ?????????????? ????????????
  • Accept — ????????????? ???????????????? ?????? ?????? ?? ???????
  • User-Agent — ?????????? ?????????? ?????????, ???????????? ??????

?????????? ??????? ???????? ????????, ???????????? ?? ?????? ??? ????????????? ??????? POST, PUT ??? PATCH. ?????? ? ?????????? ??????????????? ???????? ?????????? ? ?????? ??????? ???????????. ???? ????? ????????? ???????? ?????? ???? ??? ???????????? ?????? ????????????, ???????????? ?????? ??? ???????? ????? ?? ??????.

??????? ??????????: JSON ? XML

REST API ?????????? ?????????????? ???? ??? ???????? ???????? ????? ???????? ? ????????. ??? ???????? ???????????????? ??????? — JSON ? XML. ??????? ???????????? ?? ?????????? ??????? ? ????????????? ? ????????????? ???????????.

JSON, ??? JavaScript Object Notation, ?????????? ???????? ? ???? ??? ????-????????. ?????? ??????????????? ?????????? ? ????????? ??????. JSON ???????????? ???????? ???? ??????: ??????, ?????, ?????????? ????????, ??????? ? ???????. ??????????? ?????? ???????????????? ???????? ?????????? ??????????? ??? ?????? ? JSON.

???????????? JSON ???????? ?????????? ?????? ???????????? ??????????. ????????? JSON ?????????????? ???????, ??? ????????? ???????? ?? ?????????? ???????. ?????? ????? ? ????? ??? ?????????????. ?????? ??????????? ?????? ??? ??????????? ???-?????????? ? ????????? ??????????.

XML, ??? eXtensible Markup Language, ?????????? ??????????? ??????????? ? ???????????? ? ???????????? ??????. ?????? ???????????? ????????, ???????????? ???? ? ?????? ?????????. XML ??????????? ??????? ????????? ? ???????? ???????????. ?????? drgn ???????????? ? ????????????? ???????? ? legacy-???????????, ??????????? ??????????? ???????? ????????.

???? ??????? ??????? ? ?????????? ?????

?????? ?????????? HTTP-???? ????????? ??? ?????????? ??????? ? ?????? ????????? ???????. ???? ????????? ?? ???? ?????, ?????? ????????? ?? ???????????? ??? ??????. ?????????? ????????????? ????? ???????????? ??????????? ????????? ????????? ??????????? ?? ?????? ????????.

???? ?????? 2xx ????????????? ?? ???????? ????????? ???????. ??? 200 ?????????? ???????? ?????????? ????????. ??? 201 ?????????? ?? ???????? ?????? ???????. ??? 204 ?????????? ?? ??????? ?????????? ??? ???????? ??????????.

???? ????????? 3xx ????????????? ? ????????????????. ??? 301 ????????? ?? ???????????? ??????????? ???????. ??? 304 ???????????, ??? ?????? ?? ??????????????? ? ??????? ??????????? ???????. ?????? ????? ????????? ???????????? ?????? ??????.

???? ?????? 4xx ???????? ???? ?? ??????? ???????. ??? 400 ????????? ?? ???????????? ????????? ???????. ??? 401 ???????????? ???????????. ??? 403 ????????? ???? ? ???????. ??? 404 ?????????? ?? ?????????? ?????????? ???????.

???? ?????? 5xx ????????? ?? ????????? ???????. ??? 500 ???????? ?????????? ?????????. ??? 503 ???????? ? ??????????????? ???????????????????. ?????????? ????????? ?????? ?????? ?????? ???????????? ???? ? ???????? ????? ????????? ????????????.