VADER API

🚀 Quickstart

1. Получить API key

Обратись к админу или создай через master token:

curl -X POST https://vader.orm-bin.ru/api/admin/keys \
  -H "Authorization: Bearer <MASTER_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App", "permissions": {"verify": true, "batch": true}, "rate_limit": 1000}'

В ответе будет key — сохрани, он показывается один раз:

{
  "id": 1,
  "key": "vdr_6QdLeb3P7IRZ6WFvOGhWiP1mfeLSfU2bV5fAHHLiW6g",
  "prefix": "vdr_6QdLeb3P"
}

2. Проверить один email

curl -X POST https://vader.orm-bin.ru/api/verify \
  -H "Authorization: Bearer vdr_6QdLeb3P..." \
  -H "Content-Type: application/json" \
  -d '{"email": "test@mail.ru"}'

3. Загрузить CSV для batch

curl -X POST https://vader.orm-bin.ru/api/batch \
  -H "Authorization: Bearer vdr_..." \
  -F "file=@list.csv" \
  -F "name=My batch" \
  -F "junk_filter=true" \
  -F "split_multi=true" \
  -F "webhook_url=https://my-app.com/hook"

🔑 Authorization

Все запросы требуют заголовок Authorization: Bearer <token>.

Типы токенов

Permissions

🛰 Endpoints

Validation

{"email": "user@example.com"}

multipart/form-data: file=@list.csv

multipart/form-data:
  file=@list.csv (или cache_key из preview)
  name=My Batch
  junk_filter=true
  split_multi=true
  deduplicate=true
  webhook_url=https://...

{
  "cards": [
    {"email": "ivan@x.com", "company": "ООО Тест", "name": "Иван"},
    {"email": "sales@y.com, info@y.com", "company": "Y Ltd"}
  ],
  "name": "API Batch",
  "junk_filter": true,
  "split_multi": true,
  "mailwizz_server": "rf-email-1",
  "mailwizz_list_uid": "hn2cssaw7jaf2",
  "webhook_url": "https://..."
}

Jobs

MailWizz

{
  "job_id": 5,
  "server": "rf-email-1",
  "list_uid": "hn2cssaw7jaf2",
  "only_status": "valid"
}

Stats & Health

Admin (master token only)

💻 Examples

Python (requests)

import requests

TOKEN = 'vdr_6QdLeb3P7IRZ6WFvOGhWiP1mfeLSfU2bV5fAHHLiW6g'
BASE = 'https://vader.orm-bin.ru'

# Single verify
r = requests.post(f'{BASE}/api/verify',
    headers={'Authorization': f'Bearer {TOKEN}'},
    json={'email': 'test@mail.ru'})
print(r.json())

# Full pipeline — leads to MailWizz
r = requests.post(f'{BASE}/api/process-cards',
    headers={'Authorization': f'Bearer {TOKEN}'},
    json={
        'cards': [
            {'email': 'ivan@x.com', 'company': 'ООО Тест', 'name': 'Иван'},
        ],
        'name': 'API Batch',
        'mailwizz_server': 'rf-email-1',
        'mailwizz_list_uid': 'hn2cssaw7jaf2',
        'webhook_url': 'https://my-app.com/hook'
    })
job_id = r.json()['job_id']
print('Started job:', job_id)

Node.js (fetch)

const TOKEN = 'vdr_6QdLeb3P7IRZ6WFvOGhWiP1mfeLSfU2bV5fAHHLiW6g';
const BASE = 'https://vader.orm-bin.ru';

const res = await fetch(`${BASE}/api/verify`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({email: 'test@mail.ru'}),
});
const data = await res.json();
console.log(data);

cURL

# Verify
curl -X POST https://vader.orm-bin.ru/api/verify \
  -H "Authorization: Bearer vdr_..." \
  -H "Content-Type: application/json" \
  -d '{"email": "test@mail.ru"}'

# Batch CSV upload
curl -X POST https://vader.orm-bin.ru/api/batch \
  -H "Authorization: Bearer vdr_..." \
  -F "file=@list.csv" \
  -F "name=My batch" \
  -F "junk_filter=true"

# Download cleaned CSV
curl -O -J -H "Authorization: Bearer vdr_..." \
  "https://vader.orm-bin.ru/api/jobs/5/download?only=valid&mw_format=true"

🔔 Webhooks

При завершении job (если был webhook_url) на твой URL отправится POST:

{
  "job_id": 5,
  "name": "API Batch",
  "status": "completed",
  "processed": 1500,
  "valid": 850,
  "risky": 350,
  "invalid": 300,
  "quality_score": 78
}

⚠️ Errors

📊 Rate limits & quotas

• Per API key: rate_limit запросов в час (default 1000, настраивается)
• Max batch size: 50 MB CSV или 50,000 карточек на запрос
• Concurrency: 30 параллельных probe глобально, per-provider ограничения (Mail.ru: 20, Gmail/Outlook: 8)