API DataLeg

Для веб-студий, юристов и сервисов: те же проверки, что на сайте, — по ключу, в JSON, с вебхуками. Ключ выдаёт владелец сервиса по запросу на data@dataleg.ru.

Доступ

Ключ передаётся в заголовке Authorization: Bearer <ключ> (или X-API-Key). У каждого ключа квоты — в сутки и в месяц; каждый вызов, кроме чтения результатов и /usage, списывает одну единицу. Сверх квоты — ответ 429. Ошибки — JSON вида {"error": "…"}.

Методы

Метод	Что делает
`POST /api/v1/scans`	Полная проверка сайта. Тело: `{"url", "mode": "full"\|"quick", "webhook"?}`. Ответ 202 с `id`; результат — по `GET` или POST на `webhook` по готовности. Не больше 3 одновременных проверок на ключ.
`GET /api/v1/scans/{id}`	Статус, ход проверки и результат: находки с уровнем, нормой, штрафом и что сделать; страницы, сторонние серверы, реестр РКН. Хранится сутки.
`GET /api/v1/scans/{id}/report.pdf`	Заключение в PDF — для клиента: то же, что на сайте, с номерами страниц.
`GET /api/v1/scans/{id}/report.md`	Отчёт в Markdown — удобно передавать в свои программы и ИИ-агентам.
`GET /api/v1/domains/{домен}`	Лёгкая проверка без браузера за секунды: реестр блокировок РКН и открываемость (DNS → TCP → TLS → HTTP), сроки домена и сертификата, почта домена (MX, SPF, DKIM, DMARC), хостинг в реестре провайдеров РКН.
`GET /api/v1/inn/{ИНН}`	ЕГРЮЛ/ЕГРИП или статус самозанятого и запись в реестре операторов персональных данных РКН.
`POST /api/v1/docs`	Документы по анкете: политика, согласия, уведомление о cookie с кодом, черновик уведомления в РКН (HTML и Markdown). Формат анкеты — как на странице документов.
`POST /api/v1/watches`	Наблюдение с вебхуком: `{"url", "webhook", "mode"?}`. Раз в сутки — лёгкая проверка, раз в неделю — полная; POST на вебхук только при изменениях.
`GET /api/v1/watches`, `DELETE /api/v1/watches/{id}`	Список своих наблюдений и удаление.
`GET /api/v1/usage`	Остаток квоты ключа.

Примеры

curl -s -H "Authorization: Bearer $KEY" https://dataleg.ru/api/v1/domains/example.ru

curl -s -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.ru","mode":"full","webhook":"https://studio.example/hooks/pd152"}' \
  https://dataleg.ru/api/v1/scans
# → {"id":"…","status":"queued","status_url":"/api/v1/scans/…"}

curl -s -H "Authorization: Bearer $KEY" https://dataleg.ru/api/v1/scans/<id>

Вебхуки

POST JSON на ваш адрес (только https, только публичные адреса), до трёх попыток:

{"event": "scan.done", "id": "…", "status": "done", "result": { … }}
{"event": "watch.changed", "site": "https://example.ru/", "changes": [{"type": "new", "level": "red", "title": "…"}], "counts": {…}}

Результаты API — автоматическая проверка, не юридическое заключение. Условия — /terms.