Авторизация и ошибки
Эти маршруты относятся к внутреннему API сайта. Базовый путь — /api/v1. Для большинства операций нужна действующая пользовательская сессия в HttpOnly-cookie meetback_session. Исключение — создание сессии miniapp по проверенным данным запуска. API-ключи для внешних приложений пока не предоставляются.
Изменяющий запрос требует заголовок Origin, совпадающий с адресом MeetBack. Для JSON используйте Content-Type: application/json. Принадлежность организации и права проверяются сервером для каждого запроса.
Успешный ответ — JSON непосредственно, без оболочки data. Ошибка — HTTP 400/403/404/409/429/5xx и JSON с полем error. При 409 CARD_CHANGED откройте карточку заново и повторите изменения; не перезаписывайте чужую версию.
Не публикуйте cookies, токены приглашений и персональные данные в журналах интеграции.
Карточки, подписчики и поддержка
POST · Добавить или пригласить администратора
/organizations/{organizationId}/admins
{email}. Для подтверждённого аккаунта добавляет администратора; иначе отправляет приглашение на 7 дней и возвращает {pending:true}.
POST · Принять приглашение команды
/organization/accept
{token}. Нужен вход с подтверждённым email адресата; повторное принятие отклоняется.
DELETE · Отозвать приглашение
/organizations/{organizationId}/admin-invites/{id}
Требует staff.manage. После отзыва ссылка недействительна.
GET · Поиск площадок
/venues?q=…
До 30 результатов с адресом, городом, залами и количеством фото/событий.
POST · Создать профиль площадки
/venues
{name,cityId,address,description,latitude?,longitude?,rooms:[{name,capacity,description}]}. Требуется подтверждённый организатор.
PATCH · Изменить площадку
/venues/{id}
Те же поля плюс version. Другой организатор может дополнить профиль; устаревшая версия даёт 409.
POST · Заявить владение площадкой
/venues/{id}/claim
{note}. Права возникают только после решения администратора платформы.
POST · Сессия мини-приложения
/mini/session
{provider,initData}. Подпись и срок проверяются сервером; сессия выдаётся лишь связанному аккаунту. Сырые параметры не сохраняются.
POST · Прочитать ответы Яндекс Формы
/organizations/{organizationId}/events/{eventId}/registrations/yandex-forms
{surveyId,organizationId,organizationType,authType,token,cursor?}. Ответы передаются в мастер сопоставления и импорта; токен не сохраняется.
GET · Подписчики и история мероприятий организации
/organizations/{organizationId}/subscribers?page=1&q=Иван
Право participants.read; ответ: {page,pageSize,total,rows}.
GET · Карточка участника
/organizations/{organizationId}/events/{eventId}/registrations/{id}
Возвращает ответы, сохранённую форму, роли, группы, updatedAt и историю.
PATCH · Единое сохранение карточки
/organizations/{organizationId}/events/{eventId}/registrations/{id}
{organizerComment,expectedUpdatedAt,roles,groupIds,person?:{name,email,phone,invite},answers?:{…}}. person — только для локальной карточки; answers — для дополнительных полей аккаунта. Ошибка отменяет всю транзакцию.
POST · Загрузка аватара
/participant/avatar
multipart/form-data: file (JPEG/PNG/WebP, до 5 МБ). Ответ: {url}.
GET · Обращения пользователя
/support/tickets
Ответ: массив {id,title,status,updatedAt,organization}. ?admin=1 требует platform.support.manage.
POST · Создание обращения
/support/tickets
{body,organizationId?,errorContext?:{path,message}}. Ошибка передаётся специалисту сразу; обычный вопрос — AI по базе знаний.
GET · Чат обращения
/support/tickets/{id}
Доступ только автору и службе поддержки. Ответ: {id,title,status,errorContext,messages}.
POST · Сообщение в чат
/support/tickets/{id}/messages
{body}. Специалист отвечает от имени поддержки; пользователь продолжает диалог.
POST · Передача специалисту
/support/tickets/{id}/escalate
{}. Повторная передача не дублирует уведомление.
POST · Закрытие обращения
/support/tickets/{id}/close
{}. В закрытое обращение нельзя отправлять сообщения.