Новости продукта
Федор Жилкин
9 июн. 2025 г.
·
Обновлено
9 июл. 2026 г.
Mymeet.ai открывает REST API для интеграции данных встреч во внешние системы. Через API можно запускать запись встреч программно, получать транскрипты и отчеты, управлять встречами из своего кода - без ручных действий в интерфейсе.
Эта статья - обзор возможностей API и примеры базовых запросов с объяснением каждой части. Полная техническая документация - в конце статьи.
Что такое REST API Mymeet.ai и зачем он нужен
REST API - это набор адресов (эндпоинтов), по которым внешние приложения обращаются к Mymeet.ai. Вместо того чтобы открывать интерфейс и нажимать кнопки, ваш код отправляет запрос - и сервис возвращает данные или выполняет действие. Это нужно, когда данные встреч должны попадать в другие системы автоматически: CRM, базу знаний, аналитику или собственный инструмент команды.
Кому нужен прямой REST API Mymeet.ai
API пригодится в трех основных сценариях. Разработчикам - чтобы встроить данные встреч в свою систему, автоматически запускать запись или выгружать отчеты. Техническим командам и аналитикам - чтобы собирать данные по всем встречам воркспейса и строить аналитику поверх. Командам с нестандартными задачами - когда готовые интеграции не подходят и нужен полный контроль.
Чем REST API отличается от MCP-интеграции Mymeet.ai
API требует написания кода: вы описываете логику, отправляете запросы, обрабатываете ответы. Это гибко, но требует технических знаний. MCP (Model Context Protocol) - другой подход: вы подключаете AI-агента (Claude, Cursor, ChatGPT), и он сам обращается к данным встреч по вашей просьбе на обычном языке. Код писать не нужно. Если задача - автоматизация и системная интеграция, выбирайте API. Если нужно работать с данными встреч через AI-ассистента - читайте гайд по MCP Mymeet.ai.
[Читайте статью-гайд по МСР по ссылке]
Аутентификация через API-ключ Mymeet.ai
Каждый запрос к API должен содержать API-ключ - иначе сервис вернет ошибку и не выполнит действие. Ключ доказывает, что запрос исходит от вас, и определяет, к каким данным он получает доступ.
Где получить API-ключ для работы с REST API
API-ключ находится в настройках пользователя - раздел «API-ключ». Ключ уже создан, ничего активировать не нужно. Откройте страницу, нажмите «Копировать» - полное значение перейдет в буфер обмена. Именно это значение подставляется во все запросы вместо ваш_ключ.
На Free-тарифе страница открывается и ключ частично виден, но кнопка «Копировать» недоступна - API работает только на платных тарифах. Пересоздать ключ можно в любой момент: старый перестает работать мгновенно.
Как передавать API-ключ в запросах
Ключ передается в специальном заголовке (header) каждого запроса - строке, которая идет вместе с запросом и содержит служебную информацию. Заголовок называется X-API-KEY. Это стандартный способ авторизации в REST API - сервис читает этот заголовок и понимает, от кого пришел запрос.
В примерах ниже этот заголовок указывается в каждом запросе через флаг -H (от слова header - заголовок).
Основные возможности REST API Mymeet.ai
API покрывает весь жизненный цикл встречи: от запуска записи до получения готового отчета и управления данными. Доступно 12 методов, которые делятся на три группы по задачам.
Запись встреч и загрузка аудиофайлов через API Mymeet.ai
Через API доступны два способа получить транскрипт и отчет. Первый - отправить бота на онлайн-встречу: вы передаете ссылку на встречу, платформу и время - бот подключается автоматически. Поддерживаются Google Meet, Zoom, Microsoft Teams, Яндекс.Телемост, SberJazz, TrueConf, Контур.Толк, Jitsi. Запись можно запланировать по расписанию - например, чтобы бот автоматически подключался к каждому еженедельному синку.
Второй способ - загрузить готовый файл. Если встреча уже записана, аудио или видео можно загрузить напрямую - сервис обработает его и создаст транскрипт и отчет. Максимальный размер файла - 3 ГБ, файлы от 1 ГБ доступны на тарифах Pro и Business.
Получение транскриптов и отчетов через API
После того как встреча обработана, данные доступны через несколько методов. Обработка происходит асинхронно - это значит, что запуск записи и получение готового результата это два разных запроса, между которыми проходит время.
Статус обработки последовательно меняется: new (новая) → queued (в очереди) → processing (обрабатывается) → processed (готово). Когда статус processed, доступны:
полный JSON-отчет встречи с транскриптом, резюме и метаданными
скачивание отчета в формате PDF, DOCX, JSON или Markdown
список всех встреч воркспейса с пагинацией (постраничной навигацией)
JSON - это универсальный формат обмена данными между программами, удобен для дальнейшей обработки в коде. PDF и DOCX - для передачи людям. Markdown - для загрузки в базу знаний.
Управление встречами и шаблонами анализа через API
Помимо записи и получения данных, API позволяет управлять уже обработанными встречами. Шаблон анализа определяет, какой тип отчета будет создан: резюме, отчет по продажам, HR-интервью, исследование, протокол и другие - всего 11 вариантов. Шаблон можно задать при запуске и поменять после обработки, не перезапуская запись.
Полный список операций управления:
переименовать встречу
применить другой шаблон к уже обработанной встрече
обновить конкретную часть отчета
очистить транскрипт или восстановить его
удалить встречу
Это позволяет строить гибкие пайплайны: обработали встречу по одному шаблону, затем применили другой - без повторной обработки аудио.
Примеры запросов к REST API Mymeet.ai
Ниже - три базовых сценария с разбором каждой части кода. Примеры используют curl - стандартную утилиту для отправки HTTP-запросов, доступна в терминале на любой операционной системе. Подставьте свой ключ и реальные данные встречи.
Запустить бота на онлайн-встречу через API
Отправляем запрос с данными встречи - бот подключится автоматически.
Что означает каждая часть:
curl -X POST- отправляем данные на сервер (POST - тип запроса для создания чего-то нового)-H "X-API-KEY: ваш_ключ"- ваш ключ из настроек Mymeet.ai-H "Content-Type: application/json"- говорим серверу, что данные в формате JSON"link"- ссылка на встречу из браузера"source"- платформа:gmeet,zoom,msteams,yandextelemostи другие"template_name"- тип отчета:summaryэто стандартное резюме
При успехе сервер вернет статус 200 и данные созданной встречи, включая её ID - он понадобится для следующих запросов.
Получить список встреч воркспейса через API
Чтобы работать с конкретной встречей, нужен её уникальный ID (идентификатор - длинная строка вроде a1b2c3d4-...). Самый простой способ получить его - запросить список всех встреч.
Что означает каждая часть:
curl -X GET- получаем данные с сервера (GET - тип запроса для чтения)?page=0- номер страницы (счет с нуля, то есть0это первая страница)&perPage=10- сколько встреч показать на странице
Ответ придет в формате JSON: список встреч с их ID, названиями, датами и статусами обработки. Скопируйте нужный ID - он используется во всех запросах по этой встрече.
Скачать отчет встречи в нужном формате
Когда встреча обработана (статус processed), скачиваем готовый отчет.
Что означает каждая часть:
meeting_id=ID-вашей-встречи- уникальный ID встречи из предыдущего запросаformat=pdf- нужный формат:pdf,docx,jsonилиmd-o отчет.pdf- флаг «output», указывает куда сохранить файл. Без него содержимое выводится в терминал
Файл сохранится в папке, из которой запущен терминал. Имя файла (отчет.pdf) можно задать любое.
Тарифы и ограничения REST API Mymeet.ai
Доступность API зависит от тарифа воркспейса, к которому привязан ключ. На Free-тарифе страница API-ключа открывается и ключ частично виден - это позволяет изучить документацию и подготовить интеграцию до перехода на платный тариф. Но запросы к эндпоинтам на Free отклоняются с кодом ошибки 402.
Тариф | API-доступ | Максимальный размер файла |
Free | Ключ виден, запросы не работают | - |
Lite | Полный доступ | До 1 ГБ |
Pro | Полный доступ | До 3 ГБ |
Business | Полный доступ | До 3 ГБ |
Все запросы через API наследуют ограничения тарифа воркспейса: лимит минут, количество одновременных ботов, ограничения на встречи. Переключите воркспейс через селектор на странице API-ключа - и запросы начнут работать в рамках ограничений нового пространства.
Итог
REST API Mymeet.ai закрывает задачи, которые сложно решить через интерфейс: автоматический запуск записи, программная выгрузка транскриптов, построение аналитических пайплайнов. API-ключ уже в настройках - дополнительная активация не нужна.
Полная техническая документация со всеми эндпоинтами, параметрами и схемами ответов: → https://backend.mymeet.ai/docs/
Если нужно подключить AI-агента (Claude, Cursor, ChatGPT) без написания кода - читайте гайд по MCP Mymeet.ai.
Часто задаваемые вопросы об API Mymeet.ai
Где найти API-ключ Mymeet.ai?
В настройках пользователя - нажмите на строку «API-ключ». Ключ уже создан, ничего генерировать не нужно. На платном тарифе нажмите «Копировать» - полное значение перейдет в буфер обмена. На Free-тарифе копирование недоступно.
На каких тарифах работает REST API Mymeet.ai?
На платных: Lite, Pro и Business. На Free-тарифе страница API-ключа доступна для изучения, но запросы к эндпоинтам отклоняются с ошибкой 402 (недостаточно прав).
Как правильно передавать API-ключ в запросах?
Через заголовок X-API-KEY: ваш_ключ в каждом запросе. Заголовок - это служебная строка, которая идет вместе с запросом и содержит информацию об авторизации. В curl заголовок добавляется флагом -H.
Какие платформы для видеоконференций поддерживает API Mymeet.ai?
Google Meet, Zoom, Microsoft Teams, Яндекс.Телемост, SberJazz, TrueConf, Контур.Толк и Jitsi. Платформа указывается в поле source при запросе на запись встречи.
В каких форматах можно скачать отчет через API Mymeet.ai?
PDF, DOCX, JSON и Markdown. Формат указывается в параметре format. JSON подходит для программной обработки, Markdown - для базы знаний, PDF и DOCX - для передачи участникам.
Можно ли запланировать запись встречи по расписанию через API?
Да. При запуске записи можно указать параметр cron - расписание в стандартном формате (время в UTC). Это позволяет автоматически запускать бота на регулярные встречи - например, каждый понедельник в 10:00 - без ручных действий.
Есть ли ограничение на размер загружаемого аудиофайла?
Максимальный размер - 3 ГБ. Файлы от 1 ГБ до 3 ГБ доступны только на тарифах Pro и Business. Файл короче 30 секунд не принимается. Загрузка происходит по частям - это стандартный способ загрузки больших файлов через API.
Что такое шаблоны анализа и какие они бывают?
Шаблон определяет тип отчета по итогам встречи. Доступно 11 шаблонов: общее резюме, резюме для продаж, коучинг по продажам, HR-интервью, исследовательский отчет, протокол, резюме по спикерам и другие. Шаблон задается при запуске записи и может быть изменен после обработки - без повторной записи.
Как узнать, что встреча обработана и отчет готов?
Запросите статус встречи по её ID. Статусы меняются последовательно: new (создана) → queued (в очереди) → processing (обрабатывается) → processed (готово). При статусе processed отчет доступен для скачивания.
Где найти полную документацию REST API Mymeet.ai?
Полная документация со всеми эндпоинтами, параметрами, кодами ответов и схемами данных: https://backend.mymeet.ai/docs/
Федор Жилкин
9 июн. 2025 г.
