API документация

Программная проверка PDF-чеков Сбербанка, Т-Банка, Ozon Банка, Альфа-Банка и ЮMoney на подлинность. Базовый адрес: https://check-pdf.bliznec-go.ru/api/v1

Аутентификация

Каждый запрос на проверку требует ключ. Персональный ключ выдаётся в личном кабинете после регистрации (100 бесплатных проверок). Передавайте его заголовком:

X-API-Key: checkpdf_u_xxxxxxxxxxxxxxxx

Альтернатива для пользователей кабинета — заголовок сессии X-Session-Token: проверка спишет бесплатный лимит и попадёт в историю «Мои проверки».

Проверка чека

Параметры

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

curl -X POST https://check-pdf.bliznec-go.ru/api/v1/verify \
  -H "X-API-Key: checkpdf_u_xxxxxxxxxxxxxxxx" \
  -F "file=@receipt.pdf" \
  -F "bank=auto"

Ответ 200

{
  "verification_id": "34253185…",
  "checked_at": "2026-09-01T19:00:00+00:00",
  "requested_bank": "auto",
  "bank": "sber",
  "bank_name": "Сбербанк",
  "method": "sbp",
  "method_name": "Перевод по СБП",
  "verdict": "genuine",        // genuine | fake | inconclusive
  "confidence": 1.0,            // 0…1
  "score": 1.0,                 // балл документа: 0 — подделка, 1 — эталон
  "extracted": {
    "amount": "1 000.00 ₽", "date": "2026-07-24",
    "operation_id": "A6205…", "recipient": "Эдуард Владимирович К.",
    "sender": "Роман Сергеевич Б.", "status": "Успешно"
  },
  "checks": [
    { "id": "glyph_coverage", "label": "Покрытие глифов шрифтов",
      "status": "ok", "detail": "Все глифы встроенных шрифтов используются" }
  ],
  "notice": null,
  "remaining_checks": 99
}

Поля ответа

Служебные методы

[
  { "id": "sber", "name": "Сбербанк", "op_types": [
      { "id": "sbp",      "name": "Перевод по СБП" },
      { "id": "num_card", "name": "Перевод по номеру карты" } ] },
  { "id": "tbank",    "name": "Т-Банк",     "op_types": [ … ] },
  { "id": "ozon",     "name": "Ozon Банк",  "op_types": [ … ] },
  { "id": "alfa",     "name": "Альфа-Банк", "op_types": [ "sbp_ru", "sbp_abroad", "pay" ] },
  { "id": "yoomoney", "name": "ЮMoney",     "op_types": [ … ] }
]

Кабинет пользователя

Методы кабинета требуют заголовок сессии X-Session-Token (выдаётся при POST /api/auth/login). Файлы можно получать и параметром ?token=… — удобно для прямых ссылок на скачивание.

Коды ошибок и лимиты

Лимиты (сутки): файл до 10 МБ · 100 проверок в день · 100 генераций фейк-чеков в день (тест-лаб, настраивается) · хранение чеков 14 дней. Лимиты проверок и генераций суточные — обнуляются сами в полночь UTC.

Примеры кода

Python (requests)

import requests

r = requests.post(
    "https://check-pdf.bliznec-go.ru/api/v1/verify",
    headers={"X-API-Key": "checkpdf_u_xxxxxxxxxxxxxxxx"},
    files={"file": open("receipt.pdf", "rb")},
    data={"bank": "auto"},
)
verdict = r.json()["verdict"]
print("Вердикт:", verdict)

JavaScript (fetch)

const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("bank", "auto");

const resp = await fetch("/api/v1/verify", {
  method: "POST",
  headers: { "X-API-Key": API_KEY },
  body: form,
});
const { verdict, confidence } = await resp.json();

Нужен доступ для интеграций или увеличенный лимит — напишите в поддержку из кабинета.