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