??? ????? 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 ??????????? ? ????????? ???????????????????. ?????????? ?????????? ?????? ?????? ??????? ????????? ???? ? ???????? ???????? ????????? ????????????.