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

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

jiwiv42865

By: |

in press