Dokumentacja dla deweloperów

Dokumentacja

Instrukcje i dokumentacja API: jak uruchamiać analizy AntiBait w aplikacji webowej i z własnego kodu.

Dokumentacja API

Zapytanie IOC

Business

Wyszukuj i filtruj wskaźniki kompromitacji (IOC) zebrane z analiz e-⁠maili. Endpoint obsługuje zaawansowane filtry i paginację.

Endpoint API

GET
GET/api/iocs/query

Parametry zapytania

type?: string
isMalicious?: "true" | "false"
minThreatScore?: number
limit?: number (default: 100)
offset?: number (default: 0)
sortBy?: string (default: "last_seen")
sortOrder?: "asc" | "desc" (default: "desc")

Wszystkie parametry są opcjonalne

Odpowiedź

{
  "success": true,
  "data": [{
    "id": "string",
    "ioc_type": "string",
    "ioc_value": "string",
    "is_malicious": boolean,
    "threat_score": number,
    "first_seen": "datetime",
    "last_seen": "datetime",
    "occurrence_count": number,
    "metadata": object,
    "analysis_count": number
  }],
  "count": number,
  "pagination": {
    "limit": number,
    "offset": number
  }
}

Typy IOC

email

Adresy e-⁠mail

domain

Nazwy domen

ip

Adresy IP (IPv4/IPv6)

url

Adresy URL z treści e-⁠maila

subject

Tematy e-⁠maili

message_id

Nagłówki Message-ID

user_agent

Ciągi User-Agent

auth_result

Wyniki uwierzytelniania

Przykładowe żądania

Pobierz wszystkie złośliwe domeny

GET /api/iocs/query?type=domain&isMalicious=true&minThreatScore=70
Authorization: Bearer YOUR_API_KEY

Pobierz najnowsze IOC o wysokim zagrożeniu

GET /api/iocs/query?minThreatScore=80&sortBy=last_seen&sortOrder=desc&limit=50
Authorization: Bearer YOUR_API_KEY

Pobierz najczęstsze złośliwe adresy IP

GET /api/iocs/query?type=ip&isMalicious=true&sortBy=occurrence_count&sortOrder=desc
Authorization: Bearer YOUR_API_KEY

Pola odpowiedzi

idstring

Unikalny identyfikator IOC (UUID)

ioc_typestring

Typ wskaźnika (email, domain, ip, url itp.)

ioc_valuestring

Wartość wskaźnika

is_maliciousboolean

Czy IOC jest oznaczony jako złośliwy

threat_scorenumber

Wynik zagrożenia (0-100, wyższy = bardziej niebezpieczny)

first_seendatetime

Znacznik czasu pierwszej obserwacji IOC

last_seendatetime

Znacznik czasu ostatniej obserwacji IOC

occurrence_countnumber

Liczba obserwacji tego IOC

metadataobject

Dodatkowy kontekst i metadane IOC

analysis_countnumber

Liczba odrębnych analiz, w których pojawił się ten IOC

Typowe zastosowania

Buduj listy blokowania

Eksportuj złośliwe domeny i adresy IP do swoich narzędzi bezpieczeństwa

Śledź kampanie

Wyszukuj powtarzające się IOC, aby wykrywać skoordynowane kampanie phishingowe

Wywiad o zagrożeniach

Przeszukuj historyczne dane IOC podczas reagowania na incydenty i dochodzeń

Potrzebujesz pomocy z integracją API? Zespół wsparcia odpowiada w ciągu 24 godzin w dni robocze.