Варианты подключения

Для нового подключения основной путь — серверный API: ваш сервер обращается к Перевалу, а интерфейс остаётся частью вашего продукта. OpenAPI-клиент и ИИ-агент помогают реализовать этот же API; это инструменты разработки, а не отдельные способы подключить пользователей. Готовый порядок запросов под тип продукта — в стартах: листалка, сайт с поиском, бот.

Вариант	Для кого	Статус
Основной способ: серверный API + события	Приложения, сайты и боты со своим бэкендом	Доступно
Инструмент разработки: клиент из OpenAPI	Типизированный клиент для вызова того же API	Доступно
Инструмент разработки: ИИ-агент	Помощь в написании интеграции по документации	Доступно
Инструмент для ИИ-агента: MCP (`POST /mcp`)	Вызовы сети самим агентом с ключом API; не замена пользовательской интеграции	Доступно

API сервер-сервер

Основной и самый гибкий способ. Ваш сервер вызывает API и получает события — вебхуками или запросом GET /v1/events; приложение общается только с вашим сервером. Вы полностью управляете интерфейсом: как выглядят анкеты из сети, где показывается лента, как звучат уведомления.

Что понадобится:

Хранить у себя network_id для своих пользователей, которые в сети (приходит в ответ на PUT).
Таблицу разговоров с людьми из сети: match_id → ваш разговор.
Обработчик вебхуков с проверкой подписи и защитой от повторов. Если адреса для вебхуков нет — регулярный забор событий через GET /v1/events.
В интерфейсе: переключатели согласий, пометку «из приложения X», пометку «переведено ИИ», предупреждение о подозрительных сообщениях.

Сначала можно проверить API в песочнице; затем встроить пользовательский сценарий по руководству для вашего типа продукта.

Клиент из OpenAPI

Спецификация лежит по адресу /openapi.yaml (OpenAPI 3.1, включая вебхуки). Из неё можно сгенерировать клиента почти на любом языке:

npx @openapitools/openapi-generator-cli generate \
  -i https://pereval.dating/openapi.yaml \
  -g php -o ./pereval-client

Вместо php — python, typescript-fetch, go, java, kotlin, swift5, csharp и другие генераторы.

ИИ-агент по документации

Если интеграцию пишет ИИ-агент (Claude Code, Cursor, Copilot и подобные), дайте ему:

/llms-full.txt — вся документация и спецификация одним текстом;
/openapi.yaml — точное описание запросов и событий.

Готовая формулировка задачи для агента — на странице Для ИИ-агентов. На каждой странице документации есть кнопка «Копировать для ИИ-агента».

MCP — доступно

Тот же ключ площадки, что у REST, POST /mcp. JSON-RPC 2.0, версия протокола 2024-11-05. Методы: initialize, tools/list, tools/call, ping. Инструменты: upsert_member, get_feed, like, dislike, send_message, list_events, list_languages. Результат вызова — JSON в result.content[].text. Ключ в клиентский код не класть.

Нужна помощь

Напишите через форму связи — поможем выбрать путь, посмотрим на вашу схему данных и ответим на вопросы по интеграции. Ответ и продолжение переписки доступны на сайте по секретной ссылке, которую нужно сохранить после отправки. Входящая почта не принимается.