API v4: быстрее, умнее, унифицированнее

Рады представить NSAI API v4 — крупнейшее обновление платформы с момента запуска. Один эндпоинт для всех типов угроз, стриминг в реальном времени и кардинально быстрее.

Что нового

Унифицированный /api/v4/analyze

Больше не нужно разбираться между /api/v3/sms/check, /api/v3/crypto/analyze и /api/v3/domain/check. API v4 вводит единый эндпоинт, автоматически определяющий тип контента:

curl -X POST https://api.noscamai.com/api/v4/analyze \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Отправьте 0.5 ETH на 0x742d35Cc..."}'

Система автоматически определяет крипто-сообщение и запускает соответствующий пайплайн — анализ текста, проверку крипто-кошелька, извлечение URL — всё в одном запросе.

SSE Стриминг

Для длительных анализов v4 поддерживает Server-Sent Events:

curl -N https://api.noscamai.com/api/v4/analyze/stream \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"content": "...", "stream": true}'

События поступают последовательно: text_analysis → entity_extraction → crypto_check → final_verdict.

Пакетная обработка

Анализируйте до 100 сообщений в одном запросе. Идеально для сканирования логов, почтовых архивов или чат-экспортов:

{
  "batch": [
    {"content": "Сообщение 1...", "id": "msg-001"},
    {"content": "Сообщение 2...", "id": "msg-002"}
  ],
  "webhook": "https://your-server.com/callback"
}

Улучшения производительности

Метрика	v3	v4	Улучшение
Средняя задержка	540мс	180мс	в 3 раза
P99 задержка	2.1с	680мс	в 3 раза
Пропускная способность	50 запросов/с	200 запросов/с	в 4 раза
Пакетная обработка	—	100 сообщений	Новое

Гид миграции

Ломающие изменения

1. URL: api.noscamai.com/api/v3/* → api.noscamai.com/api/v4/*
2. Формат ответа: threat_level → risk_level
3. Заголовок авторизации: теперь нужен префикс Bearer

Совместимость

v3 эндпоинты останутся доступными до июня 2026.

Попробуйте сейчас

API v4 доступен на всех тарифах:

• Документация API
• Интерактивный API Explorer
• Тарифы