Шпаргалка

Всё главное по API на одной странице.

HTTP-методы

| Метод | Что делает | | --- | --- | | GET | Получить данные | | POST | Создать новое | | PUT | Обновить существующее | | DELETE | Удалить |

Коды статуса

| Код | Что значит | | --- | --- | | 200 | Успех, данные в ответе | | 201 | Создано (часто после POST) | | 400 | Запрос составлен неправильно | | 401 | Не авторизован: нет или неверный ключ | | 403 | Доступ запрещён | | 404 | Не найдено | | 429 | Превышен лимит запросов | | 500 | Ошибка на стороне сервиса |

Коротко: 2xx - успех, 4xx - ошибка клиента (вы), 5xx - ошибка сервера.

Глоссарий

| Термин | Что это | | --- | --- | | API | Способ, которым программы общаются: одна просит, другая отвечает. | | endpoint | Конкретный адрес-«дверь» сервиса, например /v1/users. | | header (заголовок) | Служебная пара «ключ: значение» в запросе или ответе. | | body / payload | Тело запроса - сами передаваемые данные, обычно в JSON. | | token (токен) | Строка-пропуск, по которой сервис узнаёт вас. Беречь как пароль. | | JSON | Текстовый формат данных в виде пар «ключ - значение». | | REST | Самый частый стиль API: метод плюс URL по HTTP, ответ в JSON. | | rate limit | Ограничение на число запросов за период; превышение даёт код 429. |

Куда дальше

• Курс Интеграции - как связывать сервисы между собой через их API.
• Курс LLM API - как обращаться к API нейросетей и получать ответы моделей.