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
BusinessWyszukuj i filtruj wskaźniki kompromitacji (IOC) zebrane z analiz e-maili. Endpoint obsługuje zaawansowane filtry i paginację.
Endpoint API
GET/api/iocs/queryParametry 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
emailAdresy e-mail
domainNazwy domen
ipAdresy IP (IPv4/IPv6)
urlAdresy URL z treści e-maila
subjectTematy e-maili
message_idNagłówki Message-ID
user_agentCiągi User-Agent
auth_resultWyniki uwierzytelniania
Przykładowe żądania
Pobierz wszystkie złośliwe domeny
GET /api/iocs/query?type=domain&isMalicious=true&minThreatScore=70
Authorization: Bearer YOUR_API_KEYPobierz najnowsze IOC o wysokim zagrożeniu
GET /api/iocs/query?minThreatScore=80&sortBy=last_seen&sortOrder=desc&limit=50
Authorization: Bearer YOUR_API_KEYPobierz najczęstsze złośliwe adresy IP
GET /api/iocs/query?type=ip&isMalicious=true&sortBy=occurrence_count&sortOrder=desc
Authorization: Bearer YOUR_API_KEYPola odpowiedzi
idstringUnikalny identyfikator IOC (UUID)
ioc_typestringTyp wskaźnika (email, domain, ip, url itp.)
ioc_valuestringWartość wskaźnika
is_maliciousbooleanCzy IOC jest oznaczony jako złośliwy
threat_scorenumberWynik zagrożenia (0-100, wyższy = bardziej niebezpieczny)
first_seendatetimeZnacznik czasu pierwszej obserwacji IOC
last_seendatetimeZnacznik czasu ostatniej obserwacji IOC
occurrence_countnumberLiczba obserwacji tego IOC
metadataobjectDodatkowy kontekst i metadane IOC
analysis_countnumberLiczba odrębnych analiz, w których pojawił się ten IOC
Typowe zastosowania
Eksportuj złośliwe domeny i adresy IP do swoich narzędzi bezpieczeństwa
Wyszukuj powtarzające się IOC, aby wykrywać skoordynowane kampanie phishingowe
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.