> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Dziennik phishingu e-mail > Odtwórz dziennik phishingu na poziomie zdarzeń z poprzedniego dostawcy na podstawie zdarzeń symulacji i encji raportowania /v1. Ten raport to dziennik phishingu na poziomie zdarzeń: jeden wiersz na każdą zaobserwowaną interakcję w symulacji (data, akcja, adres e-mail odbiorcy, temat, nadawca, poziom trudności). Pozostaje w formie długiej — nie scala historii danej osoby w jeden wynik. Zapytanie obejmuje ostatnie **12 miesięcy kalendarzowych** w `occurred_after` (północ UTC tego samego dnia miesiąca dwanaście miesięcy wcześniej — nie okres 365 dni). Surowy adres IP klienta nigdy nie jest dostępny w `/v1` — wynika to z zasady ochrony prywatności już w fazie projektowania, a nie z oczekującego mapowania. Typ urządzenia jest klasą pochodną w wierszu zdarzenia; surowy `user_agent` pozostaje prywatny. Zobacz [Różnice względem starszego eksportu](#r%C3%B3%C5%BCnice-wzgl%C4%99dem-starszego-eksportu). Konfiguracja, poświadczenia, stronicowanie i ponawianie po przekroczeniu limitu żądań są takie same jak w [przewodniku łączności z Power BI / Excel](/pl/developers/v1/powerbi). Najpierw dodaj wspólne zapytanie `Fn_FetchAll`; ten raport wywołuje je po nazwie. ## Wymagane zakresy klucza | Zakres | Zastosowanie | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (dołączanie adresu e-mail i nazwy wyświetlanej) | Klucz z uprawnieniem wyłącznie `simulation:read` nie może wywołać punktu końcowego zdarzeń raportowania (API zwraca `403`). Zobacz [wybór właściwego poziomu szczegółowości](/pl/developers/v1/powerbi#wyb%C3%B3r-w%C5%82a%C5%9Bciwego-poziomu-szczeg%C3%B3%C5%82owo%C5%9Bci). ## Źródłowe punkty końcowe | Punkt końcowy | Rola | | - | - | | `GET /v1/reporting/simulation_events` | Fakt na poziomie zdarzenia. Poziom szczegółowości to jedna interakcja danego typu. `email_subject`, `sender_email`, `sender_domain` i `difficulty_tier` znajdują się w tym wierszu, więc zapytanie nie dołącza wyników na poziomie kampanii dla tych pól. | | `GET /v1/entities` | Zamienia `entity_id` na adres e-mail / nazwę wyświetlaną. Zdarzenie raportowania nie zawiera adresu e-mail odbiorcy (twarde wykluczenie w module odczytu raportowania). Przejście przez `/entities` pozwala wypełnić starszą kolumnę „email”. | Dozwolone filtry na liście zdarzeń (każdy inny zwraca `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Ta rodzina raportowania jest [zestawem danych w wersji zapoznawczej](/pl/developers/v1/powerbi#zbiory-danych-raportowych-w-wersji-zapoznawczej-phishing-na-poziomie-os%C3%B3b). Schemat zestawu danych i zasady dotyczące danych możesz sprawdzić pod adresami `GET /v1/reporting/datasets` i `GET /v1/reporting/datasets/simulation_events`. ### Poziom szczegółowości Jeden wiersz na zdarzenie symulacji raportowania. Osoba, która otworzyła, a następnie kliknęła tę samą wiadomość, generuje dwa wiersze. Zdarzenia z wartością null w `entity_id` (brak uczestnika będącego aktorem / odbiorcą / celem) również są uwzględniane — `email` ma wtedy wartość null. Okno API jest poszerzone o jedną minutę; dokładna granica `occurred_at >= WindowStart` jest ponownie stosowana lokalnie, aby ostatni rok nie zależał od tego, czy serwer traktuje `occurred_after` jako włączny, czy wyłączny. Budżet żądań: jedno stronicowane przejście przez zdarzenia w oknie oraz jedno przejście przez encje. Zawsze ustawiaj `limit = "500"`. ## Mapowanie kolumn Nazwy starszych kolumn pochodzą z eksportu poprzedniego dostawcy. Pola `/v1` to publiczne nazwy API; zapytanie nadaje niektórym z nich aliasy na potrzeby raportu. | Kolumna starsza | Pole `/v1` lub sposób wyliczenia | Kolumna raportu | | - | - | - | | Date | `Event.occurred_at` (jako data; surowy `occurred_at` jest zachowany jako `datetimezone`) | `date` | | Action | `Event.event_type` — zamknięty zbiór tokenów wymieniony poniżej | `action` | | Email | `Entity.email` (dołączenie po `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` — liczba całkowita 1–5, 1 najłatwiejszy, 5 najtrudniejszy | `difficulty` | | Raw IP | Nigdy w `/v1` | Pominięta, nie ustawiona na null | | Device type | `Event.device_type` — klasa pochodna; null, gdy zdarzenie nie ma klasy pochodnej | `device_type` | ### Tokeny akcji `action` to zamknięty token raportowania. Starsze „Email Sent” odpowiada `simulation.delivered` (`delivered` to publiczny czasownik; token przesyłany w sieci to `simulation.delivered`). | Wartość `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Dodatkowe pola zachowane, ponieważ udostępnia je API: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at` oraz `entity_type` i `entity_status` z dołączenia encji. ## Różnice względem starszego eksportu * **Surowy adres IP nigdy nie jest dostępny.** `/v1` nie udostępni surowego adresu IP klienta — wynika to z zasady ochrony prywatności już w fazie projektowania, a nie z oczekującego mapowania. Zapytanie nie dodaje kolumny zastępczej z adresem IP. * **Typ urządzenia jest pochodny, a nie surowy.** `device_type` to pochodna klasa urządzenia dla zdarzeń kliknięcia, przesłania i zgłoszenia. Obserwowane tokeny obejmują `desktop`, `mobile`, `tablet` i `unknown`, ale emiter zapisuje dowolny ciąg znaków — traktuj go jako tekst otwarty, a nie zamknięte wyliczenie. Ma wartość null, gdy zdarzenie nie ma klasy pochodnej, a surowy ciąg `user_agent` pozostaje prywatny. * **„Email Sent” to `simulation.delivered`.** Używaj tego tokenu podczas filtrowania lub liczenia wysłanych wiadomości. Nie szukaj starszego ciągu `email_sent`. * **Adres e-mail odbiorcy jest dołączany, a nie jest polem zdarzenia.** Zdarzenie raportowania pomija adres e-mail; zapytanie przechodzi przez `/entities`, aby go uzupełnić. * **Ostatnie 12 miesięcy kalendarzowych**, a nie okres 365 dni ani pełna historia. * **Forma długa, bez scalania.** Jeden wiersz na interakcję, a nie jeden wynik na osobę. ## Dalsze kroki Poświadczenia, stronicowanie i ładowanie tych zapytań w Power BI lub Excel. Zestawienie kliknięć, podania poświadczeń i zgłoszeń dla każdej osoby z ostatnich 12 miesięcy. Zapisy na Szkolenia na poziomie osoba × przypisanie. Nadaj `reporting:read` i `entity:read` kluczowi, który odświeża ten raport. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.