# RealIQ — CRM, документы и проверки сделок с недвижимостью RealIQ — российская платформа для агентств недвижимости: лиды, объекты, сделки, документы и проверки работают в одном контексте. Платформа связывает продавца, объект и документы, сохраняет источники и ограничения и показывает, что проверить до следующего шага сделки. ## Основные страницы - Главная: https://realiq.ru/ - CRM для агентства недвижимости: https://realiq.ru/crm-dlya-agentstva-nedvizhimosti - Лиды: https://realiq.ru/crm/lidy - Генератор документов к сделке: https://realiq.ru/generator-dokumentov-k-sdelke - Шаблоны и согласование документов агентства: https://realiq.ru/dokumenty-agentstva - Проверка продавца: https://realiq.ru/proverka-prodavca - Проверка объекта: https://realiq.ru/proverka-obekta - Проверка документов: https://realiq.ru/proverka-dokumentov - Проверка под ключ: https://realiq.ru/sdelka-pod-klyuch - Кабинет сделки: https://realiq.ru/kabinet-sdelki - Источники и методика: https://realiq.ru/sources - Справочник перед сделкой: https://realiq.ru/guide - Цифровая доказательность: https://realiq.ru/digital-proof - Проверка подлинности отчёта: https://realiq.ru/verify - Тарифы: https://realiq.ru/tarify - Сведения об ИТ-деятельности и разработчике: https://realiq.ru/it-company ## Материалы справочника - Проверка продавца перед авансом: https://realiq.ru/guide/proverka-prodavca-nedvizhimosti - Проверка квартиры перед покупкой: https://realiq.ru/guide/kak-proverit-kvartiru-pered-pokupkoy - Что проверить перед авансом: https://realiq.ru/guide/chto-proverit-pered-avansom - ЕГРН и кадастр: https://realiq.ru/guide/kak-proverit-obekt-po-egrn-i-kadastru - Особые статусы объекта: https://realiq.ru/guide/osobye-statusy-obekta-nedvizhimosti - Документы на квартиру: https://realiq.ru/guide/kak-proverit-dokumenty-na-kvartiru - Банкротство продавца: https://realiq.ru/guide/proverka-prodavca-na-bankrotstvo - Должная осмотрительность: https://realiq.ru/guide/dolzhnaya-osmotritelnost-pokupatelya - SHA-256 и цифровая метка: https://realiq.ru/guide/sha-256-i-cifrovaya-metka-otcheta - RealIQ и выписка ЕГРН: https://realiq.ru/guide/chem-real-iq-otlichaetsya-ot-vypiski-egrn - API RealIQ: https://realiq.ru/guide/api-realiq-dlya-integraciy - Мониторинг проверки: https://realiq.ru/guide/monitoring-kak-nepreryvnaya-dolzhnaya-osmotritelnost - Доказательность через API: https://realiq.ru/guide/dokazatelnost-cherez-api - Кабинет сделки для агентства: https://realiq.ru/guide/kabinet-sdelki-dlya-agentstva ## Важные ограничения - RealIQ не является юридической консультацией и не гарантирует исход сделки. - Недоступность источника не означает отсутствие риска и показывается отдельным статусом. - Конкретный состав источников зависит от вида проверки, входных данных, региона и доступности внешних систем. - Сложные правовые выводы должен оценивать профильный юрист или иной ответственный специалист. ## API v1 Этот раздел помогает подключать API RealIQ к ИИ-инструментам, CRM, серверным приложениям и автоматизации. Основная документация API: - Руководство для разработчика: https://realiq.ru/developers - Инструкция для ИИ-инструментов: https://realiq.ru/developers/ai-integration - Схема OpenAPI: https://api.realiq.ru/api/v1/openapi.json - Документация Swagger: https://api.realiq.ru/api/v1/docs - Объяснение цифровой доказательности: https://realiq.ru/digital-proof - Проверка подлинности отчёта: https://realiq.ru/verify Базовый адрес: - https://api.realiq.ru/api/v1 Авторизация: - Передавайте API-ключ в HTTP-заголовке: X-API-KEY: - Тестовые ключи начинаются с riq_test, не вызывают боевые источники и не списывают баланс. - Боевые ключи начинаются с riq_live и могут списывать баланс агентства. - Не раскрывайте API-ключи в клиентском коде. Используйте их только на серверной стороне. Основной сценарий для проверок продавца, объекта и полной проверки: 1. POST /checks/quote — рассчитать цену и проверить баланс. 2. POST /checks с type seller, object или full и input_data. 3. Сохранить полученный check_id. 4. Опросить GET /checks/{check_id}, пока status не станет report_ready, partial или failed. 5. Прочитать result, pdf_url/report_url и evidence. 6. При необходимости проверить хеши через GET /verify/{sha256}. Статусы: - processing: проверка ещё выполняется. - report_ready: итоговый результат и отчёт готовы. - partial: результат готов, но часть источников не ответила. - failed: проверка завершилась ошибкой. Важные методы: - POST /checks/quote: рассчитать цену. - POST /checks: запустить одну проверку. - POST /checks/bulk: запустить до 50 проверок. - GET /checks: получить список API-проверок. - GET /checks/{check_id}: получить статус, результат и доказательный блок. - POST /document-check: загрузить и проанализировать документ. - GET /document-check/{job_id}: получить результат проверки документа. - POST /valuation: запустить оценку объекта. - GET /valuation/{valuation_id}: получить результат оценки. - POST /monitors: создать регулярный мониторинг. - GET /monitors: получить список подписок мониторинга. - GET /balance: проверить баланс. - GET /tariffs: получить цены API. - GET /verify/{sha256}: проверить хеш отчёта, данных или доказательного блока. Минимальный пример curl: ```bash curl -X POST https://api.realiq.ru/api/v1/checks \ -H "Content-Type: application/json" \ -H "X-API-KEY: riq_test_xxx" \ -H "Idempotency-Key: crm-check-1001" \ -d '{"type":"seller","input_data":{"seller":{"last_name":"Иванов","first_name":"Иван","birth_date":"1980-01-01","region":"Москва"}}}' ``` Рекомендации для ИИ-инструментов и интеграций: - Используйте схему OpenAPI как источник структуры запросов и ответов. - Начинайте с тестовых ключей и sandbox_status report_ready/partial/failed для проверки веток. - Используйте Idempotency-Key для POST /checks и /checks/bulk. - Считайте partial готовым результатом с ограничениями источников, а не полной ошибкой. - Не показывайте source_not_connected или source_unavailable как not_found. - Сохраняйте request_id в журналах для поддержки. - Сохраняйте check_id, status, risk_score, pdf_url, evidence.check_evidence_root_hash и evidence.sources. - Не прошивайте цены в коде; вызывайте /checks/quote или /tariffs. Поля доказательного блока: - evidence.check_evidence_root_hash - evidence.pdf_sha256 - evidence.data_snapshot_sha256 - evidence.evidence_manifest_sha256 - evidence.datestamp - evidence.tsa - evidence.sources[].source_code - evidence.sources[].datestamp - evidence.sources[].normalized_result_sha256 Типовые ошибки: - validation_error: тело запроса некорректно. - invalid_check_type: type должен быть seller, object или full. - insufficient_funds: баланса агентства недостаточно. - scope_denied: API-ключ не разрешает этот метод. - rate_limit_exceeded: слишком много запросов. - idempotency_conflict: тот же Idempotency-Key использован с другим телом. - source_unavailable: внешний источник временно недоступен. Поддержка: - Передавайте request_id, check_id и метод API при обращении в поддержку.