Содержание
Как подключить API Make: первый запрос
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 18 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Как подключить API Make: первый запрос строится из трёх действий — создать токен аутентификации, выбрать endpoint и отправить запрос с заголовком Authorization. В документации для разработчиков Make описан стартовый сценарий: получить список хранилищ данных команды через GET-запрос к /data-stores. Ниже — порядок действий, учебный пример и способы проверить результат самостоятельно. Мы скачали подборку результатов веб-поиска по запросу «Как подключить API Make: первый запрос»: текст отдали 10 из 10.
Прямой ответ и границы продукта
Make REST API даёт доступ к данным платформы через HTTP-запросы. В документации для разработчиков сказано, что API позволяет работать с данными Make и управлять платформой без открытия графического интерфейса, встраивать функции Make в своё ПО и автоматизировать задачи. Для работы нужен аккаунт Make: после входа можно создать токен аутентификации или запросить клиент OAuth 2.0.
Границы стоит держать в голове сразу. REST API — это программный доступ к ресурсам платформы. Приложение HTTP внутри Make — другой инструмент: оно соединяет сценарии с внешними сервисами, у которых нет готовой интеграции с Make. Приложение Make — третий инструмент: оно управляет модулями, сценариями, папками, логами, командами, подключениями, функциями IML, вебхуками и пользователями внутри аккаунта Make. Для приложения Make нужен платный аккаунт.
Мы сняли подборку результатов веб-поиска по запросу «Как подключить API Make: первый запрос»: текст отдали 10 из 10 страниц. Медиана объёма читаемого текста топа — 591 слово. Метку 2026 года несут 7 из 10 прочитанных страниц.
| Инструмент | Что делает | Где документация |
|---|---|---|
| Make REST API | Доступ к данным платформы по HTTP | developers.make.com |
| Приложение HTTP | Связь сценария с внешним API | apps.make.com/http |
| Приложение Make | Управление объектами аккаунта Make | apps.make.com/make |
Разделяйте цель запроса и место использования ключа. Токен Make создаётся в профиле и передаётся REST API через Authorization; приложение Make также может использовать ключ из профиля в своём подключении. Для внешнего сервиса через HTTP нужны учётные данные именно этого сервиса.
Условия доступа и источник требований
Аккаунт Make — базовое условие. В документации для разработчиков указано: чтобы использовать Make API, нужен аккаунт Make, а после входа можно создать токен аутентификации или запросить клиент OAuth 2.0. Токен даёт доступ к ресурсам Make в зависимости от роли и назначенных scopes.
Порядок создания токена описан в справочном центре Make. Нужно нажать на иконку профиля в правом верхнем углу и выбрать Profile. Затем открыть вкладку API access и нажать кнопку Add token. Далее выбрать необходимые Scopes и ввести Label для токена. Список scopes можно сверить в документации Make API. Нажатие кнопки Add подтверждает выбор.
Скопированный ключ показывается целиком один раз. В справочном центре сказано: скопируйте новый API-ключ в буфер обмена и сохраните в надёжном месте, это единственный момент, когда виден весь ключ. Созданные ключи перечислены в профиле на вкладке API Access, где их можно просматривать и управлять ими.
| Шаг | Действие | Где |
|---|---|---|
| 1 | Открыть профиль | Иконка в правом верхнем углу |
| 2 | Перейти в API access | Вкладка профиля |
| 3 | Нажать Add token | Кнопка на вкладке |
| 4 | Выбрать Scopes и Label | Форма токена |
| 5 | Подтвердить кнопкой Add | Форма токена |
| 6 | Скопировать ключ | Единственный показ |
Источник актуальных требований — документация Make API на developers.make.com. Там же лежит раздел аутентификации: Make API требует аутентификации запросов с помощью API-токенов или подключения OAuth 2.0, а неаутентифицированные запросы возвращают ошибку аутентификации.
Документированный порядок действий
Стартовый сценарий в документации для разработчиков описан так: чтобы сделать первый вызов API, нужно выполнить несколько действий. Первое — создать токен аутентификации. Токен даёт доступ к ресурсам Make API в зависимости от роли и назначенных scopes, и его обязательно включать в заголовок Authorization всех запросов. Перед самим токеном ставится слово Token и пробел.
Второе действие — выбрать endpoint, соответствующий нужному ресурсу. В примере документации это /data-stores. Endpoint требует параметр запроса teamId, который ставится после знака вопроса в URL. Параметр pg[sortDir] в этом примере задаёт направление сортировки.
Третье — собрать полный запрос и отправить его. В примере используется cURL, а метод GET выбран потому, что данные нужно получить без изменения. Четвёртое — оценить ответ: API возвращает 200 OK и список всех хранилищ данных указанной команды. При неудаче приходит код ошибки, и документация отсылает к разделу об устранении неполадок.
Шаблон URL из документации выглядит так: {zone_url}/api/v2/data-stores?teamId={teamId}&pg%5BsortDir%5D=asc. Здесь zone_url — зона Make, с которой идёт взаимодействие, например https://eu1.make.com.
curl --location \
--request GET 'https://eu1.make.com/api/v2/data-stores?teamId=35&pg%5BsortDir%5D=asc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token 93dc8837-2911-4711-a766-59c1167a974d'
Токен в примере — образец, его нельзя использовать в своих запросах, нужен собственный. Для методов POST, PUT и PATCH тело запроса включается всегда.
Учебный пример и критерии проверки
Разберём запрос из документации для команды с ID 35. В URL задано pg[sortDir]=asc, то есть сортировка по возрастанию; это же значение возвращается в блоке pg. Подставьте свою зону, teamId и токен. В исходном пояснении документации упомянуто убывание, поэтому для учебной проверки ориентируемся на фактический параметр запроса и ответа.
Ответ приходит в формате JSON. В примере документации он содержит массив dataStores с двумя объектами: у первого id 15043, имя Old data store, 10 записей, размер 620, максимальный размер 1048576, teamId 35; у второго id 13433, имя New data store, 1 запись, размер 48, максимальный размер 1048576, teamId 35. Ниже идёт блок pg с полями сортировки: sortBy name, limit 10000, sortDir asc, offset 0.
Критерии самостоятельной проверки:
- HTTP-статус ответа равен 200 OK.
- В теле есть массив
dataStoresс ожидаемыми объектами. - Поле
teamIdв каждом объекте совпадает с тем, что вы передали. - Блок
pgотражает выбранное направление сортировки. - При ошибке код отличается от 200 и указывает на причину.
Такой набор проверок отделяет успешный запрос от частично верного: статус 200 при пустом массиве тоже возможен, если у команды нет хранилищ данных. Тогда проверяйте сам факт ответа и структуру полей.
Смежные варианты и выбор по задаче
Выбор инструмента зависит от задачи. REST API подходит, когда нужно программно читать и менять данные платформы из своего кода. Приложение HTTP в Make подходит, когда сценарий должен обратиться к внешнему сервису без готовой интеграции: в документации приложения сказано, что оба модуля поддерживают аутентифицированные и неаутентифицированные запросы.
Приложение Make подходит для управления объектами аккаунта изнутри сценариев. В его документации перечислены модули: включение и выключение расписания сценария, список незавершённых выполнений, повтор и удаление незавершённых выполнений, создание или обновление пользовательской функции IML. Для приложения Make нужен платный аккаунт.
| Задача | Инструмент | Тип подключения |
|---|---|---|
| Читать данные платформы из кода | REST API | Токен или OAuth 2.0 |
| Обратиться к внешнему сервису | HTTP-модуль | No auth, API key, Basic Auth, OAuth 2.0 |
| Управлять сценариями из сценария | Приложение Make | OAuth2 или API key |
В HTTP-модуле тип аутентификации выбирается по требованиям целевого сервиса. В документации перечислены варианты: без аутентификации для запросов без учётных данных, API key когда провайдер требует ключ, Basic Auth когда нужны логин и пароль, OAuth 2.0 когда нужны Client ID и Client Secret. Учётные данные рекомендуется задавать в отдельном поле Credentials: это предотвращает раскрытие ключей в запросах и централизует управление ими.
Типичные проблемы и диагностика
Первая частая проблема — ошибка аутентификации. В документации сказано: если запросы не аутентифицированы, Make API возвращает ошибку аутентификации. Проверка: убедитесь, что заголовок Authorization присутствует и содержит слово Token, пробел и сам токен.
Вторая — неверный параметр. Endpoint /data-stores требует teamId; без него запрос не отработает. Проверка: сверьте URL с шаблоном из документации, где параметр стоит после знака вопроса.
Третья — неверная зона. zone_url указывает на зону Make, с которой идёт взаимодействие, например https://eu1.make.com. Проверка: подставьте свою зону вместо образца.
Четвёртая — небезопасное соединение. В документации HTTP-модуля сказано: Make разрешает только защищённый HTTPS, а соединения с непроверенными самоподписанными сертификатами отклоняются. Проверка: URL начинается с https://.
Пятая — изменение запроса при редиректе. Для модуля HTTP документация различает коды и исходные методы: в блоке 301/302 метод GET или HEAD сохраняется, а POST меняется на GET. Проверьте конечный URL, фактический метод и параметры; одного кода 301 недостаточно, чтобы считать запрос неизменным.
Частые вопросы
Что такое api make com?
Это поисковая формулировка, за которой стоит документация Make API на домене developers.make.com. Там описан REST API платформы: доступ к данным Make через HTTP-запросы, создание токена аутентификации и запрос клиента OAuth 2.0. Начинать стоит с раздела для разработчиков и раздела аутентификации.
Как получить токен для API Make?
Откройте профиль через иконку в правом верхнем углу, перейдите на вкладку API access и нажмите Add token. Выберите нужные Scopes, введите Label и подтвердите кнопкой Add. Скопируйте ключ сразу: целиком он показывается один раз. Управлять ключами можно в том же профиле на вкладке API Access.
Какой первый запрос отправить?
Первый запрос из документации — GET к /data-stores с параметром teamId и сортировкой. В заголовке Authorization укажите слово Token, пробел и свой токен. Ответ 200 OK вернёт список хранилищ данных команды. При ошибке обратитесь к разделу об устранении неполадок.
Чем REST API отличается от приложения HTTP?
REST API даёт доступ к данным платформы Make из вашего кода. Приложение HTTP соединяет сценарий Make с внешними сервисами, у которых нет готовой интеграции. У них разные точки входа и разные способы аутентификации. Выбор зависит от того, куда направлен запрос: внутрь платформы или наружу.
Нужен ли платный аккаунт?
Для REST API документация называет условием аккаунт Make, а после входа доступны токен или OAuth 2.0. Для приложения Make в документации прямо указано требование платного аккаунта Make. Это разные инструменты, и требования к ним различаются. Сверяйтесь с актуальной страницей тарифов перед началом работы.
Для запуска моделей на своём железе пригодятся материалы Nemotron GGUF: как запустить модель локально и Llama cpp Android: как запустить модель на телефоне. Если работаете с открытыми моделями, посмотрите YandexGPT локально: как запустить открытую модель, а для управления из мессенджера — Claude Code Telegram: как подключить управление.
