Перейти к основному содержимому

API или скрипты Coverse

Кроме API, в таблицах Coverse есть скрипты: программы на JavaScript, которые хранятся в таблице и выполняются на сервере Coverse. Скрипту не нужен ваш сервер и токен API: он запускается кнопкой, по расписанию, при изменении таблицы, при отправке формы и по вебхуку.

Полная документация по скриптам — в базе знаний: Скрипты Coverse.

Что выбрать​

ЗадачаПодходит
Данные пишет и читает ваша система: 1С, CRM, сайт, ботAPI
Нужно реагировать на изменения таблицы в вашей системеAPI, вебхуки
Логика внутри таблицы: пересчёт, раскраска, отчёты, архивскрипты
Регулярная задача без своего сервера: отчёт в Telegram каждое утро, загрузка курсовскрипты
Внешний сервис должен передать данные, а своего сервера нетскрипт с триггером «По вебхуку»
Разовая задача словами через ИИ-ассистентаAI-агенты (MCP)

Сравнение подробнее — в статье Что такое скрипты.

Как API и скрипты работают вместе​

  • Запись через API запускает скрипт. Изменения, которые ваша система записала через API, запускают триггер скрипта «При изменении таблицы». В событии поле event.source равно "api", а изменённые ячейки приходят в event.changes. Так можно, например, дописывать заказ через API, а раскраску и уведомление менеджеру делать скриптом.
  • Скрипт не запускает себя по кругу. Изменения, которые делает сам скрипт, триггер «При изменении» не запускают.
  • Вебхук в скрипт вместо своего сервера. Если внешний сервис умеет только отправлять запросы, дайте ему адрес триггера скрипта «По вебхуку». Скрипт получит тело запроса и запишет данные в таблицу. См. Вебхуки скриптов.
  • Защита одинаковая. Скрипт другого участника и токен API подчиняются одним и тем же правилам защиты листов и диапазонов.

Готовые руководства по интеграциям​

Для популярных сервисов в базе знаний есть пошаговые руководства со скриптами. Если ваша задача из этого списка, своего сервера и вызовов API не понадобится:

Лимиты​

У скриптов свои лимиты: 30 секунд на запуск и 300 минут в сутки на владельца таблицы на тарифе «Бизнес». Лимиты API описаны в разделе Лимиты, лимиты скриптов — в статье Лимиты скриптов.