# Pereval

> Pereval (pereval.dating) is an open network that connects dating apps: a user stays in their own app but sees, likes and chats with (machine-translated) people from other apps in the network. Basic integration is free. Optional boost, superlike, incognito and rewind start at zero RUB; explicit backend spending-account enrollment is required. TEST credits are not money. Platforms apply on the site, get keys for test and live environments in the dashboard and integrate through a REST API plus signed webhooks or event polling.

Key facts: base URL https://api.pereval.dating; auth `Authorization: Bearer <api_key>` (server-side only); `external_id` = partner's own user id; `network_id` = UUID of a member of another app; webhooks are signed with HMAC-SHA256 of the raw body (`X-Network-Signature: sha256=<hex>`) and must be deduplicated by event `id`; users must opt in (`consent.network: true`).

## For dating platforms and users

- [For dating platforms](https://pereval.dating/en/platforms/): how to connect and integrate a dating service
- [For users](https://pereval.dating/en/users/): where network profiles come from and how to manage participation
- [Площадкам знакомств](https://pereval.dating/ru/platforms/): как подключить сервис к сети «Перевал»
- [Пользователям](https://pereval.dating/ru/users/): откуда берутся сетевые анкеты и как управлять участием

## Machine-readable

- [OpenAPI 3.1 spec](https://pereval.dating/openapi.yaml): every endpoint, field, error and webhook
- [Full docs as one text](https://pereval.dating/llms-full.txt): all guides plus the spec

## Docs (English)

- [Overview](https://pereval.dating/en/docs/)
- [Test the API in the sandbox](https://pereval.dating/en/docs/quickstart/)
- [Swipe app](https://pereval.dating/en/docs/guide-app/)
- [Search site](https://pereval.dating/en/docs/guide-site/)
- [Bot](https://pereval.dating/en/docs/guide-bot/)
- [How the network works](https://pereval.dating/en/docs/concepts/)
- [Ways to integrate](https://pereval.dating/en/docs/integration/)
- [Optional services and pricing](https://pereval.dating/en/docs/services/)
- [Members and consent](https://pereval.dating/en/docs/members/)
- [Feed, likes, matches](https://pereval.dating/en/docs/feed-matches/)
- [Messages and translation](https://pereval.dating/en/docs/messages/)
- [Events and webhooks](https://pereval.dating/en/docs/webhooks/)
- [Safety and rules](https://pereval.dating/en/docs/safety/)
- [API reference](https://pereval.dating/en/docs/reference/)
- [Errors and limits](https://pereval.dating/en/docs/errors/)
- [For AI agents](https://pereval.dating/en/docs/ai-agents/)
- [Testing](https://pereval.dating/en/docs/testing/)
- [Changelog](https://pereval.dating/en/docs/changelog/)

## Docs (Russian)

- [Обзор](https://pereval.dating/ru/docs/)
- [Проверить API в песочнице](https://pereval.dating/ru/docs/quickstart/)
- [Приложение-листалка](https://pereval.dating/ru/docs/guide-app/)
- [Сайт с поиском](https://pereval.dating/ru/docs/guide-site/)
- [Бот](https://pereval.dating/ru/docs/guide-bot/)
- [Как устроена сеть](https://pereval.dating/ru/docs/concepts/)
- [Варианты подключения](https://pereval.dating/ru/docs/integration/)
- [Дополнительные услуги и цены](https://pereval.dating/ru/docs/services/)
- [Анкеты и согласия](https://pereval.dating/ru/docs/members/)
- [Лента, лайки, мэтчи](https://pereval.dating/ru/docs/feed-matches/)
- [Сообщения и перевод](https://pereval.dating/ru/docs/messages/)
- [События и вебхуки](https://pereval.dating/ru/docs/webhooks/)
- [Безопасность и правила](https://pereval.dating/ru/docs/safety/)
- [Справочник API](https://pereval.dating/ru/docs/reference/)
- [Ошибки и лимиты](https://pereval.dating/ru/docs/errors/)
- [Для ИИ-агентов](https://pereval.dating/ru/docs/ai-agents/)
- [Тестирование](https://pereval.dating/ru/docs/testing/)
- [Журнал изменений](https://pereval.dating/ru/docs/changelog/)