GET /api/v1/verify/{sha256}

Проверка цифрового следа

Метод проверяет, относится ли SHA-256 к отчёту, снимку данных, корневому хешу доказательного блока или хешу манифеста внутри аккаунта API-ключа.

Открыть в Swagger API в базе знаний

Кратко для ИИ

Когда использовать

Партнёрская CRM или архив сделки показывает проверку подлинности без ручного входа в кабинет RealIQ.

Карта методов

Связанные методы

Эта страница описывает группу связанных методов. Для точной схемы параметров используйте Swagger, для продуктовой логики — блоки ниже.

GET/api/v1/verify/{sha256_value}

Проверить, относится ли SHA-256 к отчёту, снимку данных или доказательному блоку RealIQ.

Сценарий

Как проходит сценарий

Шаг 1

Получение SHA

Возьмите SHA из PDF, доказательного блока или QR-страницы.

Шаг 2

Проверка

Передайте SHA в /verify/{sha256_value} с ключом того же аккаунта.

Шаг 3

Показ результата

Если found=true, покажите kind, check_id и доказательный блок связанной проверки.

Обязательные поля

Поле	Обяз.	Описание
sha256	Да	64 hex-символа проверяемого отпечатка.
X-API-KEY	Да	Ключ того же аккаунта, где была создана проверка.

Пример curl

curl https://api.realiq.ru/api/v1/verify/0123456789abcdef... \
  -H "X-API-KEY: riq_live_xxx"

JSON-запрос

Пример JSON-запроса

Для GET-методов показано JSON-представление URL, query-параметров и заголовков. Для загрузки файла показана структура form-data.

{
  "method": "GET",
  "endpoint": "/api/v1/verify/ab12...9f00",
  "headers": {
    "X-API-KEY": "riq_live_xxx"
  }
}

JSON-ответ

Пример успешного JSON-ответа

Пример отражает структуру реального ответа API. Значения ID, SHA и ссылок сокращены или заменены демонстрационными.

{
  "valid": true,
  "found": true,
  "sha256": "ab12c4d5e6f78900112233445566778899aabbccddeeff001122334455667788",
  "kind": "pdf_sha256",
  "check_id": "b9f6f2f0-b8c1-4f1c-bb8f-3cf3a9dc3b5a",
  "check_type": "full",
  "status": "report_ready",
  "created_at": "2026-06-28T12:00:00Z",
  "completed_at": "2026-06-28T12:01:18Z",
  "evidence": {
    "check_evidence_root_hash": "9f4a...0d71",
    "pdf_sha256": "ab12...9f00",
    "sources": [
      {
        "source_code": "fssp",
        "datestamp": "2026-06-28",
        "normalized_result_sha256": "0f4c...9a21"
      }
    ]
  },
  "request_id": "req_1780000000_abcd"
}

Полный JSON-ответ

Полный пример ответа

Развёрнутый пример показывает, какие блоки обычно получает интегратор. Значения ID, SHA, ссылок и персональных данных демонстрационные.

{
  "valid": true,
  "found": true,
  "sha256": "ab12c4...9f00",
  "kind": "pdf_sha256",
  "check_id": "b9f6f2f0-b8c1-4f1c-bb8f-3cf3a9dc3b5a",
  "check_type": "full",
  "status": "report_ready",
  "created_at": "2026-06-28T12:00:00Z",
  "completed_at": "2026-06-28T12:01:18Z",
  "evidence": {
    "check_evidence_root_hash": "9f4a6c...0d71",
    "pdf_sha256": "ab12c4...9f00",
    "data_snapshot_sha256": "73ce44...aa91",
    "tsa": {
      "status": "not_configured",
      "provider": null,
      "token_sha256": null,
      "completed_at": null
    },
    "datestamp": {
      "value": "2026-06-28T12:01:18Z",
      "provider": "RealIQ",
      "created_at": "2026-06-28T12:01:18Z"
    },
    "verify_url": "https://realiq.ru/verify",
    "sources": [
      {
        "source_code": "fssp",
        "source_name": "ФССП",
        "status": "ok",
        "datestamp": "2026-06-28",
        "normalized_result_sha256": "0f4c2b...9a21"
      }
    ]
  },
  "request_id": "req_1780000000_abcd"
}

Поля ответа

Как читать поля ответа

Поле	Что означает
valid/found	valid=true означает, что SHA относится к цифровому следу RealIQ.
kind	Тип совпадения: pdf_sha256, data_snapshot_sha256, evidence_root_hash и т.п.
check_id/check_type/status	Связанная проверка, если доступна этому API-ключу.
evidence	Доказательный блок найденной проверки.

Ошибки

Типовые ошибки метода

HTTP 400invalid_sha256

SHA не похож на 64 hex-символа.

Что делать: Передайте полный SHA-256.

{
  "error_code": "invalid_sha256",
  "message": "SHA не похож на 64 hex-символа.",
  "request_id": "req_1780000000_abcd"
}

HTTP 401unauthorized

Неверный API-ключ.

Что делать: Проверьте X-API-KEY.

{
  "error_code": "unauthorized",
  "message": "Неверный API-ключ.",
  "request_id": "req_1780000000_abcd"
}

HTTP 404not_found

SHA не найден в рамках аккаунта.

Что делать: Проверьте, тем ли ключом создан отчёт.

{
  "error_code": "not_found",
  "message": "SHA не найден в рамках аккаунта.",
  "request_id": "req_1780000000_abcd"
}

Ответ processing

{
  "found": false,
  "kind": null,
  "request_id": "req_..."
}

Ответ report_ready

{
  "found": true,
  "kind": "pdf_sha256",
  "check_id": "...",
  "evidence": { "check_evidence_root_hash": "...", "sources": [] },
  "request_id": "req_..."
}

Пример ошибки

{
  "error_code": "invalid_sha256",
  "message": "SHA-256 должен содержать 64 hex-символа.",
  "request_id": "req_..."
}

Что списывается с баланса

Проверка SHA не списывает баланс.

Какие поля доказательного блока вернутся

Возвращает найденный доказательный блок, если SHA относится к проверке этого аккаунта.