Здесь разберемся, что такое API и как программы общаются между собой. Это базовое знание для любой автоматизации — раз поняли, дальше будет легче.
Ключевые понятия
- API (Application Programming Interface): Способ, которым одна программа общается с другой. Забудьте расшифровку, запомните суть: это «переводчик» или «официант» для софта.
- Запрос (Request): Команда, которую мы отправляем через API. Например, «создай новую задачу» или «дай мне список всех клиентов».
- Ответ (Response): Данные, которые мы получаем от API после запроса.
- Endpoint (Точка входа): Конкретный URL-адрес, по которому нужно обращаться к API для выполнения определённого действия. У каждого действия (создать, удалить, получить) свой endpoint.
- API-документация: Инструкция, в которой описано, какие команды (запросы) понимает API и как с ним работать.
Источник: A Beginner’s Guide to APIs
Как одна программа (например, Gmail) может работать с другой (например, Google Sheets)? Ответ — через API.
Для объяснения API отлично подходит аналогия с рестораном. Представьте, что вы пришли в ресторан:
- Вы (клиент) — это ваше приложение (например, n8n).
- Кухня — это внешний сервис, к которому вы обращаетесь (например, Google Sheets или Telegram).
- Официант — это и есть API. Вы не идёте на кухню сами, а общаетесь через посредника, который принимает ваш заказ и приносит готовое блюдо.
В этой метафоре:
- Вы (клиент в ресторане) = Ваше приложение (n8n).
- Официант =
API(интерфейс, который принимает запросы и приносит ответы). - Кухня = Внешний сервис (Google Sheets, Salesforce).
- Меню =
API-документация(описывает, что можно заказать). - Ваш заказ (“Стейк медиум-рер”) =
HTTP-запрос. - Готовое блюдо =
HTTP-ответ. - Специфика заказа (“Для столика №5, без орехов”) =
Headers(заголовки с метаданными). - Детали заказа (“Хочу именно этот стейк”) =
Body(тело запроса).
На практике:
- Gmail публикует свой API: “Вот как запросить письма, вот какие данные я отправлю в ответ”
- Google Sheets публикует свой API: “Вот как добавить новую строку, вот какой формат мне нужен”
- Make.com (ваш официант) соединяет их по этим правилам
Типы запросов (Основные операции)
Все действия с API сводятся к четырём основным типам запросов. Это стандартные команды, которые понимает почти любой API:
- POST (Создать): Отправить данные для создания чего-то нового.
- Пример: Клиент заполнил форму на сайте. Мы отправляем POST-запрос в CRM, чтобы создать новую сделку.
- GET (Получить): Запросить существующие данные.
- Пример: Мы хотим получить список всех задач из Notion. Мы отправляем GET-запрос и получаем их в ответ.
- PUT / PATCH (Обновить): Изменить существующие данные.
- Пример: У клиента в CRM изменился номер телефона. Мы отправляем PUT-запрос, чтобы обновить его карточку.
- DELETE (Удалить): Стереть данные.
- Пример: Мы отправляем DELETE-запрос, чтобы удалить выполненную задачу из Trello.
Частые заблуждения
Нужно быть программистом, чтобы работать с API
Наверное, самый честный ответ — нет, но основы понимать придётся. Платформы вроде Make.com или n8n прячут сложность за красивыми блоками, но если нужного вам сервиса нет в списке, придётся заглянуть в API-документацию. Это как инструкция к сложному прибору — читать не хочется, но иногда необходимо. К тому же, в наши дни вы можете отправить документацию в ChatGPT или Claude и попросить объяснить конкретный API — нейросети отлично справляются с переводом технического текста на человеческий язык.
У любого софта есть API
Нет. Если у программы нет API, автоматизировать её «штатными» способами практически невозможно. Прежде чем выбрать сервис, всегда проверяйте, есть ли у него публичная API-документация.
Важно знать: каждый сервис определяет свои правила работы с API — какие методы доступны, платность, нужны ли ключи доступа. Например, у OpenAI и Telegram разные требования, но принцип один: вам понадобится API-ключ (см. 105 API keys), вы будете отправлять данные в формате JSON (см. 104 JSON), и получать ответ обратно в том же формате.
Что делать дальше
- Откройте API-документацию любого сервиса, которым пользуетесь. Вот примеры простых для понимания API:
- GIPHY API — легко запросить случайный гифку
- OpenWeatherMap API — получить данные о погоде по городу
Просто загуглите «<название сервиса> API documentation».
- Не пугайтесь! Попробуйте найти в документации знакомые слова:
GET,POST,DELETE. Посмотрите, какие данные можно создавать, получать или удалять. В документации часто показаны примеры запросов в форматеcurl— вы можете скопировать такой пример, отправить его в ChatGPT или Claude с просьбой переписать для n8n, и нейросеть адаптирует код для вашей платформы. n8n из коробки понимаетcurlформат - Найдите свой API-ключ: В настройках профиля многих сервисов есть раздел «API». API-ключ — это ваш уникальный «пароль» для доступа к API. Никому его не показывайте. О том, как безопасно хранить ключи, читайте в 105 API keys.
- Главное — понять, как данные бегают между программами и превращаются в другие данные. Платформы (Make.com, n8n, Zapier) меняются и обновляются, а принципы работы API остаются одинаковыми. Раз вы поняли, как отправить запрос и получить ответ, вы сможете работать с любым инструментом — все они в основе своей делают именно это.
Обсудить статью с ботом
— @ask_aimindset_bot — бот поддержки
Дальше
→ 104 JSON