🔄 Жизненный цикл проверки и статусы

Быстрая проверка выполняется асинхронно: запрос на создание или перезапуск ставит задачу в очередь и сразу возвращает карточку проверки. Данные (risk, analysis, info, labels) появляются в этой же карточке позже — их нужно забрать повторным запросом.

📊 Значения поля status

Других значений поле не принимает.

✅ Как понять, что проверка готова

Признак готовности — пара условий: status === 2 и updated_at больше значения, которое было в момент запуска.

t0 = updated_at из ответа на PUT /api/fast-check (или GET /api/fast-check/{id}/run)
готово, когда  status == 2  И  updated_at > t0

⚠️ Как отличить «проверено» от «данных не получили»

Если провайдеры не вернули данные, проверка завершится со status: 2, а объект risk будет выглядеть так:

{
  "score": 0,
  "risk_detail": null,
  "providers": {}
}

Пустой providers вместе с score: 0 означает, что оценку получить не удалось, и адрес не следует считать чистым. У успешной проверки в providers всегда есть хотя бы один источник, например {"m": 12} или {"f": 100}.

⏱️ Сколько ждать

Проверки одного аккаунта обрабатываются последовательно, одна за другой. Типичное время одной проверки — от нескольких секунд до пары минут (до четырёх обращений к внешним провайдерам с таймаутом 120 с каждое).

При постановке пачки адресов (например, 50 адресов кошелька) последняя проверка в очереди может завершиться через несколько минут после первой. Разумный таймаут ожидания — 10 минут; если за это время status не стал 2, повторите запуск через GET /api/fast-check/{id}/run.

🔁 Рекомендуемый цикл опроса

# 1. Поставить проверку (или перезапустить существующую)
curl -X PUT 'https://amlkyc.tech/api/fast-check' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json' \
  -d 'address=TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA' \
  -d 'currency=usdt' \
  -d 'network=trx'
# => {"id": 1234, "uuid": "...", "status": 0, "updated_at": "2026-09-11T10:14:45.000000Z", ...}

# 2. Через 5-10 секунд опросить одну проверку...
curl 'https://amlkyc.tech/api/fast-check/1234' \
  -H 'Authorization: Bearer <API_TOKEN>' -H 'Accept: application/json'

# 3. ...или, если проверок много, забрать их одним запросом
curl 'https://amlkyc.tech/api/fast-check?limit=50&updated_from=2026-09-11' \
  -H 'Authorization: Bearer <API_TOKEN>' -H 'Accept: application/json'