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

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

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

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

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

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

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