Подключение Make через HTTP-модуль
Приложение Marcomm AI для Make на проверке. До одобрения вызывайте API Marcomm AI из сценария Make с помощью HTTP-модуля и личного ключа API.
- 1В Marcomm откройте Настройки → Интеграции → Make, чтобы увидеть состояние и нужные значения.

На странице Make видно текущее состояние, шаги, значения для копирования и то, одобрен ли доступ к API для этого рабочего пространства. - 2Откройте Настройки → API. Если у рабочего пространства ещё нет доступа к API, владелец или администратор заполняет Заявка на доступ к API и выбирает Отправить заявку.
- 3После одобрения откройте Создать ключ, выберите Личный ключ, отметьте нужные Области доступа и выберите Создать ключ. Сразу скопируйте ключ: он показывается только один раз.
- 4В сценарии Make добавьте модуль HTTP и выберите Make a request.
- 5Укажите эндпоинт из документации для разработчиков после
https://marcomm.works/api/v1и добавьте заголовокAuthorizationсо значениемBearerи вашим ключом.
Начните с GET /me, чтобы проверить ключ, прежде чем собирать остальной сценарий.
Приложение Marcomm AI для Make на проверке, и добавить его пока нельзя. После одобрения его модуль Make an API call будет вызывать любой эндпоинт из справочника API тем же личным ключом. До тех пор ту же работу выполняет HTTP-модуль. События Marcomm AI можно также отправлять на адрес вебхука Make, который вы добавляете на вкладке Вебхуки в Настройки → API.
Области доступа определяют, что может ключ. Контент (content) читает пресс-релизы, записи блога и пресс-мероприятия, Создание контента (content:write) создаёт и правит черновики, Публикация и рассылка (distribution) публикует и отправляет по почте, а Согласования (approvals) отвечает за шаги согласования. Последние три работают только с типом Личный ключ, потому что действие записывается на человека, создавшего ключ. Ключ рабочего пространства может только читать, а каждый ключ действует с ролью и правами своего создателя.
Публикацию и рассылку нельзя отменить. API выполняет их только если в запросе есть confirm: true или заголовок Idempotency-Key, и ничего не публикует, отвечая 409, пока нужно согласование или материал запланирован либо находится под эмбарго. Повтор с тем же Idempotency-Key и тем же запросом в течение 24 часов возвращает первый результат, а не выполняется снова. В HTTP-модуле добавляйте заголовок Idempotency-Key к каждому запросу на запись сами.
API доступен на тарифе Team и выше. Команда Marcomm AI проверяет каждую заявку, и ключи работают только после одобрения. Ключ может использовать только области, одобренные для рабочего пространства, а у каждого человека может быть до 10 ключей. По умолчанию рабочее пространство может отправлять 60 запросов в минуту и 10 000 в день; сверх этого API отвечает 429 с заголовком Retry-After. Чтобы повысить лимиты, используйте Нужны более высокие лимиты? в Настройки → API. Чтобы отключить Make, выберите Отозвать рядом с ключом; системы, которые им пользуются, сразу теряют доступ.
Частые вопросы
Вызовите
GET https://marcomm.works/api/v1/meс заголовкомAuthorization: Bearerи вашим ключом. Это работает с любым одобренным ключом независимо от его областей и возвращает рабочее пространство, имя ключа и его области.Ключ не хранит, какой сервис его использует, поэтому Marcomm не отмечает карточку Make как подключённую. В Настройки → API видно, когда каждый ключ использовался в последний раз.
Укажите
https://marcomm.works/api/v1и путь из документации для разработчиков, например/press-releasesдля списка пресс-релизов.