Эндпоинты и REST простыми словами

Эндпоинт — это одна позиция в меню. Это просто URL (Uniform Resource Locator, единый указатель ресурса), который делает одну конкретную вещь. Например:

• https://api.weather.com/forecast — получить прогноз
• https://api.weather.com/cities — список доступных городов

Та же кухня, разные блюда. Каждый эндпоинт — это одна возможность.

Большинство API, с которыми вы столкнётесь, следуют нестрогому стилю под названием REST (Representational State Transfer, передача репрезентативного состояния). Вам не нужно академическое определение; вам нужны две идеи:

• URL называет вещь («ресурс») — пользователя, заказ, прогноз.
• Глагол говорит, что вы хотите с ней сделать. Эти глаголы — методы HTTP (HyperText Transfer Protocol, протокол передачи гипертекста), те же самые, что и из главы про то, как работает веб:
  • GET — прочитать что-то (получить прогноз). Безопасно; ничего не меняет.
  • POST — создать что-то (сделать заказ, зарегистрировать пользователя).
  • PUT / PATCH — обновить что-то, что уже существует.
  • DELETE — удалить что-то.

Так что GET /orders/42 означает «прочитать заказ номер 42», а DELETE /orders/42 означает «удалить его». То же существительное, другой глагол, совершенно другой эффект. Когда вы читаете документацию API или диф, эти два слова — метод и URL — говорят вам о большей части того, что делает запрос.