технический гайд

API простыми словами

API - это способ, которым программы общаются между собой: одна просит данные или действие, другая отвечает. Этот гайд объясняет с нуля и без жаргона, как устроен запрос, как сервис понимает, кто вы, какие бывают API и как самому отправить первый запрос.

Программировать не обязательно. Чтобы понять API, достаточно разобраться в логике запроса и ответа - покажем на живых примерах.

Начать с начала →Сразу к устройству запроса Шпаргалка

о чём этот гайд

Слышу про API, но не понимаю

Везде «дёрни апишку», «отдай по API». Разберём на простой аналогии, что это и зачем.

Нужно дёрнуть чужой сервис

Хочу получить данные из стороннего сервиса. Что отправить, куда и как прочитать ответ.

Хочу попробовать руками

Без программирования: curl, Postman и пара строк на Python к открытому API.

главы гайда

Что такое API

Интерфейс-контракт, через который одна программа просит что-то у другой. Аналогия с официантом между вами и кухней. Зачем это нужно.

Как устроен запрос

HTTP-запрос по частям: метод, URL, заголовки, тело, ответ и коды статуса. Формат данных JSON. Живой пример запроса и ответа.

Аутентификация и лимиты

Как сервис понимает, кто вы: API-ключ, Bearer-токен, OAuth. Лимиты запросов и код 429. Где хранить ключ, чтобы его не украли.

Какие бывают API

REST, GraphQL, WebSocket, gRPC. Публичные и внутренние. Когда какой подходит, без лишней теории.

Как попробовать

Инструменты: curl, Postman, браузер. Реальный запрос к открытому API через curl и Python. Как читать документацию.

Шпаргалка

Таблица методов и кодов статуса, глоссарий терминов и ссылки на смежные курсы - всё на одной странице.