Изменения API

Этот журнал предназначен для разработчиков подключённых площадок: новые возможности, исправления поведения и действия при обновлении интеграции. История внутренней разработки до первого стабильного контракта сохранена в архиве репозитория и не является списком публичных версий API. Косметические изменения сайта сюда не включаются.

1.0.0 — первый стабильный публичный контракт

Первая стабильная версия объединяет действующие возможности сети в один документированный контракт. Адреса /v1/..., ключи, форматы запросов и событий сохраняются; повторная регистрация и перенос данных не требуются. В GET /v1/capabilities версия обозначается как protocol_version: "1.0.0". Перед использованием проверьте фактически выложенную версию своего контура и необходимые capabilities.

• Участие и анкеты. Явное согласие, синхронизация анкет, собственные external_id, тестовый и боевой контуры; скрытие, удаление и восстановление аккаунта по описанным правилам.
• Знакомства. Лента и поиск с фильтрами и курсорами, обычные лайки, дизлайки, входящие лайки и мэтчи. Коммерческой платы за срок жизни мэтча нет.
• Переписка и события. Сообщения с возможностью перевода, оригинал при сбое перевода, прочтение и история; подписанные вебхуки или polling, устойчивые повторы сообщений и правила обработки запоздалых событий/удалений.
• Безопасность. Модерация, фотопроверка, жалобы, блокировки, сроки хранения и независимое разделение площадок. Capabilities описывают конфигурацию, а не доступность внешнего AI-сервиса.
• Необязательные услуги. Буст, суперлайк, инкогнито и отмена решений. Все стартуют с нулевой цены; рабочие RUB-заказы отделены от TEST-кредитов. Подключение расходного аккаунта явное, существующие интеграции до него сохраняют прежнее поведение.
• Ограничения первого релиза. Видео в production выключено, звонков нет. Положительные RUB-платежи, автоматическая программа бонусов и коммерческие операции через MCP пока не предоставляются. Базовые MCP-инструменты сохраняются; версия самого MCP-протокола остаётся 2024-11-05.

Подробные поля и ошибки — в справочнике API, условия дополнительных услуг — в отдельном руководстве.

Как читаются следующие версии

• 1.0.1 — совместимое исправление.
• 1.1.0 — новая возможность с сохранением совместимости.
• 2.0.0 — несовместимый контракт с отдельным планом перехода. О несовместимых изменениях предупреждаем площадки минимум за 60 дней; прежняя версия поддерживается в течение этого периода.

Версия релиза Site независима от версии API. Возможность используется только когда она доступна в вашем контуре, даже если уже описана в документации.