Как получить доступ к встречам через API

Через API ваши встречи из MeetLog можно читать из других программ: CRM, базы знаний, таск-трекера или собственного скрипта. Статья для тех, кто настраивает такую интеграцию сам или передаёт ключ разработчику.

Что можно получить через API

API работает только на чтение. Через него доступны:

• транскрипции — список встреч и полный текст каждой расшифровки;
• отчёты — список отчётов и текст каждого в формате Markdown;
• проекты — список проектов и встречи в каждом из них.

В ответы попадают только готовые встречи и отчёты. Изменять или удалять данные через API нельзя.

Как создать ключ

1. Откройте Настройки → API ключи.
2. Нажмите Создать ключ.
3. Укажите Название, например по имени сервиса, который будет пользоваться ключом.
4. В блоке Разрешения отметьте, что ключу можно читать: Чтение транскрипций, Чтение отчётов, Чтение проектов. Нужно выбрать хотя бы одно.
5. Если ключ нужен на время, задайте Срок действия (необязательно).
6. Нажмите Создать, затем Скопировать и сохраните ключ в надёжном месте.

Осторожно

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

Как пользоваться ключом

Передавайте ключ в заголовке Authorization каждого запроса. Все адреса API начинаются с https://meetlog.ru/api/v1/export/. Например, список ваших расшифровок:

curl -H "Authorization: Bearer <ваш_ключ>" \
  "https://meetlog.ru/api/v1/export/transcripts?page=1&page_size=20"

Полное описание запросов и ответов — на странице API документация. На неё ведёт кнопка Документация API в разделе API ключи и ссылка внизу сайта.

Ограничения

• Не больше 60 запросов в минуту на один ключ. Если лимит превышен, API вернёт ошибку 429 и подскажет, через сколько секунд можно повторить запрос.
• Списки отдаются по страницам, до 100 элементов на странице.
• Ключ видит те же встречи, что и вы: свои и встречи команд, в которых вы состоите.

Как отозвать ключ

В разделе Настройки → API ключи найдите ключ в списке и нажмите Отозвать. Все интеграции с этим ключом перестанут работать сразу. В списке также видно, когда ключ создан, когда им пользовались в последний раз и когда истекает его срок.

Частые вопросы

Нужен ли платный тариф для API? Нет, создать ключ можно на любом тарифе.

Сколько ключей можно создать? Можно выпустить отдельный ключ для каждой интеграции. Лимит в 60 запросов в минуту действует на каждый ключ отдельно, а при отзыве одного ключа остальные продолжат работать.

Почему API отвечает ошибкой 403? У ключа нет нужного разрешения. Например, чтобы получать отчёты, ему нужно разрешение Чтение отчётов. Создайте новый ключ с нужными разрешениями.

Можно ли получить через API аудио или субтитры? Нет. Через API доступны только тексты расшифровок, отчёты и проекты. Субтитры можно скачать на странице встречи.