Как пользоваться AUDITOR

Первый аудит

1. Регистрация — создаётся личное пространство на Free.
2. Создайте проект: вставка кода, ZIP или Git.
3. Запустите проверку и дождитесь статуса с бэкенда (не симулируем прогресс).
4. Смотрите findings: подозрение ≠ подтверждение. Evidence — вход, шаг, результат.

Findings и evidence

Подтверждённая проблема воспроизведена тестом. Подозрение — сигнал без стабильного сбоя. Мы не обещаем найти все дефекты и не выдаём «гарантию чистоты» после зелёного аудита.

Лимиты

Лимиты и entitlements считает бэкенд (план, Audit Units, размер проекта). Фронт не дублирует проверки. Исчерпание квоты — сообщение от API, не «фейковый апгрейд». Тарифы: /pricing.

Cloud и Private Runner

Cloud: мы уже проверяем код у себя (готовый сервис на nullab.space). Private Runner (опционально): агент у вас, исходники по умолчанию не уезжают. Self-Hosted / без облачных AI — «скоро», не продаём как готовое. Настройки пространства → «Где проверять». Enterprise: /contact.

Public API

Authorization: Bearer aud_live_…

# проекты
curl -sS -H "Authorization: Bearer $AUDITOR_API_KEY" \
  https://nullab.space/api/v1/projects

# старт аудита
curl -sS -X POST -H "Authorization: Bearer $AUDITOR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"…","branch":"main","executionMode":"CLOUD"}' \
  https://nullab.space/api/v1/audits

# статус / результат / отмена
GET  /audits/:id
GET  /audits/:id/result
POST /audits/:id/cancel

Scopes: me:read, projects:read|write, audits:read|write, findings:read, evidence:read, usage:read, webhooks:read|write, keys:manage. Ключ не шире RBAC пространства. Создать ключ: Настройки → API-ключи.

CLI

auditor login
auditor project list
auditor audit run --project <id>
auditor audit status <auditId>
auditor audit wait <auditId>
auditor audit result <auditId>
auditor usage

Коды выхода CLI соответствуют реализации в apps/cli (0 — ок, ненулевые — ошибка сети/auth/квоты/аудита). Fixes API не публикуем как стабильный v1, пока Auto Fix не готов.

Webhooks

CRUD вебхуков: /api/v1/webhooks. Доставки и подпись — как в OpenAPI. Секреты не логируем.