> ## 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. # Logg över e-postphishing > Återskapa en tidigare leverantörs phishinglogg på händelsenivå från /v1 reporting simulation events och entities. Den här rapporten är en phishinglogg på händelsenivå: en rad per observerad simuleringsinteraktion (datum, åtgärd, mottagarens e-postadress, ämne, avsändare, svårighetsgrad). Den förblir i långformat – en persons historik slås inte samman till ett enda resultat. Frågan omfattar de senaste **12 kalendermånaderna** i `occurred_after` (midnatt UTC på samma dag i månaden tolv månader tillbaka – inte en period på 365 dagar). Klientens råa IP-adress finns aldrig på `/v1` – det är integritet genom design, inte en väntande mappning. Enhetstyp är en härledd klass på händelseraden; rådata i `user_agent` förblir privata. Se [Avvikelser från den äldre exporten](#avvikelser-fr%C3%A5n-den-%C3%A4ldre-exporten). Konfiguration, autentiseringsuppgifter, paginering och nya försök vid hastighetsbegränsning fungerar på samma sätt som i [anslutningsguiden för Power BI / Excel](/sv/developers/v1/powerbi). Lägg först till den delade frågan `Fn_FetchAll`; den här rapporten anropar den vid namn. ## Nödvändiga nyckelbehörigheter | Behörighet | Används för | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (koppling av e-postadress och visningsnamn) | En nyckel som endast har beviljats `simulation:read` kan inte anropa slutpunkten för rapporteringshändelser (API:et returnerar `403`). Se [välj rätt detaljnivå](/sv/developers/v1/powerbi#v%C3%A4lj-r%C3%A4tt-granularitet). ## Källslutpunkter | Slutpunkt | Roll | | - | - | | `GET /v1/reporting/simulation_events` | Faktatabell på händelsenivå. Detaljnivån är en typad interaktion. `email_subject`, `sender_email`, `sender_domain` och `difficulty_tier` finns på den här raden, så frågan kopplar inte in resultat på kampanjnivå för dessa fält. | | `GET /v1/entities` | Översätter `entity_id` → e-postadress / visningsnamn. Rapporteringshändelsen utelämnar mottagarens e-postadress (ett hårt undantag i rapporteringsläsaren). Genomgång av `/entities` är det sätt på vilket den äldre kolumnen ”email” fylls i. | Tillåtna filter för händelselistan (allt annat returnerar `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Den här rapporteringsfamiljen är en [förhandsgranskningsdatamängd](/sv/developers/v1/powerbi#f%C3%B6rhandsgranskningsdataset-f%C3%B6r-rapportering-n%C3%A4tfiske-per-person). Granska datamängdens schema och dataprinciper på `GET /v1/reporting/datasets` och `GET /v1/reporting/datasets/simulation_events`. ### Detaljnivå En rad per rapporteringssimuleringshändelse. En person som öppnade och sedan klickade på samma meddelande ger två rader. Händelser med ett null-värde för `entity_id` (ingen aktör / mottagare / målmottagare) visas ändå – `email` är null. API-fönstret utökas med en minut; den exakta gränsen för `occurred_at >= WindowStart` tillämpas på nytt lokalt, så att det senaste året inte beror på om servern behandlar `occurred_after` som inklusive eller exklusive. Begäranbudget: en paginerad genomgång av händelser i fönstret, plus en genomgång av entiteter. Ange alltid `limit = "500"`. ## Kolumnmappning Äldre kolumnnamn kommer från din tidigare leverantörs export. `/v1`-fälten är de offentliga API-namnen; frågan använder alias för några av dem i rapporten. | Äldre kolumn | `/v1`-fält eller härledning | Rapportkolumn | | - | - | - | | Date | `Event.occurred_at` (som datum; rått `occurred_at` behålls som `datetimezone`) | `date` | | Action | `Event.event_type` – slutna token som anges nedan | `action` | | Email | `Entity.email` (koppling via `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – heltal 1–5, där 1 är lättast och 5 svårast | `difficulty` | | Raw IP | Finns aldrig på `/v1` | Utelämnas, inte null | | Device type | `Event.device_type` – härledd klass; null när händelsen saknar härledd klass | `device_type` | ### Åtgärdstoken `action` är den slutna rapporteringstoken. Äldre ”Email Sent” mappas till `simulation.delivered` (`delivered` är det offentliga verbet; token i själva överföringen är `simulation.delivered`). | `action`-värde | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Extra fält som behålls eftersom API:et har dem: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, samt `entity_type` och `entity_status` från entitetskopplingen. ## Avvikelser från den äldre exporten * **Rå IP-adress är aldrig tillgänglig.** `/v1` exponerar inte klientens råa IP-adress – det är integritet genom design, inte en väntande mappning. Frågan lägger inte till någon platshållarkolumn för IP. * **Enhetstyp är härledd, inte rå.** `device_type` är en härledd enhetsklass för klick-, inskicknings- och rapporteringshändelser. Observerade token är bland annat `desktop`, `mobile`, `tablet` och `unknown`, men sändaren lagrar en fri sträng – behandla den som öppen text, inte som en sluten uppräkning. Den är null när händelsen saknar härledd klass, och den råa `user_agent`-strängen förblir privat. * **”Email Sent” är `simulation.delivered`.** Använd den token när du filtrerar eller räknar utskick. Leta inte efter en äldre `email_sent`-sträng. * **Mottagarens e-postadress är en koppling, inte ett fält på händelsen.** Rapporteringshändelsen utelämnar e-postadressen; frågan går igenom `/entities` för att fylla i den. * **Senaste 12 kalendermånaderna**, inte en period på 365 dagar och inte hela historiken. * **Långformat, inte sammanslaget.** En rad per interaktion, inte ett resultat per person. ## Nästa steg Autentiseringsuppgifter, paginering och inläsning av dessa frågor i Power BI eller Excel. Sammanställning per person över klick, inloggningsuppgifter och rapporterade meddelanden för 12 månader. Utbildningsregistreringar på nivån person × tilldelning. Bevilja `reporting:read` och `entity:read` för den nyckel som uppdaterar den här rapporten. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.