раздел 05
Шпаргалка
Всё главное по 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 нейросетей и получать ответы моделей.