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

REST API ?????????? ????? ????????????? ??????? ??? ?????????? ???-????????, ??????????? ??????????? ?????????? ??????????? ????? ????????. ?????????? REST ???????????????? ??? Representational State Transfer. API ????????? ????????? ????? ??????? ???????????? ????????. REST API ????????? ????????????? HTTP-????????? ??? ???????? ?????? ????? ???????? ? ????????. ?????? ?????????? ?????? ?? ??????, ????????? ??????????? ?????? ? ????????. ?????? ????????? ?????? drgn ? ????????????? ????? ? ?????????????? ???????, ???? ????? ? 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 ?????????? ? ??????????????? ?????????????. ?????????? ????????? ?????? ?????? ??????? ????????? ?????? ? ???????? ????? ??????????? ????????????.