> ## 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. # E-mail-phishinglog > Genskab en tidligere udbyders phishinglog på hændelsesniveau ud fra /v1-rapporteringens simulationshændelser og entiteter. Denne rapport er en phishinglog på hændelsesniveau: én række pr. observeret simulationsinteraktion (dato, handling, modtagerens e-mail, emne, afsender, sværhedsgrad). Den forbliver i langt format – den samler ikke en persons historik i ét enkelt resultat. Forespørgslen omfatter de seneste **12 kalendermåneder** i `occurred_after` (midnat UTC på samme dag i måneden for tolv måneder siden – ikke en varighed på 365 dage). Rå klient-IP findes aldrig på `/v1` – det er privacy by design og ikke en afventende mapping. Enhedstype er en afledt klasse på hændelsesrækken; den rå `user_agent` forbliver privat. Se [Afvigelser fra den tidligere eksport](#afvigelser-fra-den-tidligere-eksport). Opsætning, legitimationsoplysninger, paginering og genforsøg ved rate limit er de samme som i [vejledningen til Power BI-/Excel-forbindelse](/da/developers/v1/powerbi). Tilføj først den delte `Fn_FetchAll`-forespørgsel; denne rapport kalder den ved navn. ## Påkrævede nøgleomfang | Omfang | Anvendes til | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (join på e-mail og visningsnavn) | En nøgle, der kun har fået `simulation:read`, kan ikke kalde endpointet for rapporteringshændelser (API'en returnerer `403`). Se [vælg det rette detaljeringsniveau](/da/developers/v1/powerbi#v%C3%A6lg-den-rette-granularitet). ## Kildeendpoints | Endpoint | Rolle | | - | - | | `GET /v1/reporting/simulation_events` | Faktatabel på hændelsesniveau. Detaljeringsniveauet er én tastet interaktion. `email_subject`, `sender_email`, `sender_domain` og `difficulty_tier` findes på denne række, så forespørgslen joiner ikke resultater på kampagneniveau for disse felter. | | `GET /v1/entities` | Opløser `entity_id` → e-mail / visningsnavn. Rapporteringshændelsen udelader modtagerens e-mail (en fast udelukkelse på rapporteringslæseren). Gennemløb af `/entities` er den måde, den tidligere kolonne "email" udfyldes på. | Tilladte filtre på hændelseslisten (alt andet returnerer `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Denne rapporteringsfamilie er et [forhåndsvisningsdatasæt](/da/developers/v1/powerbi#reporting-preview-datas%C3%A6t-phishing-pr-person). Undersøg datasættets skema og datapolitikker på `GET /v1/reporting/datasets` og `GET /v1/reporting/datasets/simulation_events`. ### Detaljeringsniveau Én række pr. rapporteringssimulationshændelse. En person, der åbnede og derefter klikkede på den samme besked, giver to rækker. Hændelser med en null-værdi for `entity_id` (ingen aktør / modtager / målrettet deltager) vises stadig – `email` er null. API-vinduet udvides med ét minut; den præcise `occurred_at >= WindowStart`-grænse anvendes igen lokalt, så det seneste år ikke afhænger af, om serveren behandler `occurred_after` som inklusiv eller eksklusiv. Anmodningsbudget: ét pagineret gennemløb af hændelser i vinduet plus ét gennemløb af entiteter. Angiv altid `limit = "500"`. ## Kolonnemapping De tidligere kolonnenavne stammer fra din tidligere udbyders eksport. `/v1`-felterne er de offentlige API-navne; forespørgslen giver nogle af dem aliasser i rapporten. | Tidligere kolonne | `/v1`-felt eller afledning | Rapportkolonne | | - | - | - | | Date | `Event.occurred_at` (som dato; rå `occurred_at` bevares som `datetimezone`) | `date` | | Action | `Event.event_type` – lukkede tokens er angivet nedenfor | `action` | | Email | `Entity.email` (join på `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier` – heltal 1–5, 1 er nemmest, 5 er sværest | `difficulty` | | Raw IP | Findes aldrig på `/v1` | Udeladt, ikke sat til null | | Device type | `Event.device_type` – afledt klasse; null, når hændelsen ikke har nogen afledt klasse | `device_type` | ### Handlingstokens `action` er det lukkede rapporteringstoken. Den tidligere "Email Sent" mappes til `simulation.delivered` (`delivered` er det offentlige verbum; wire-tokenet er `simulation.delivered`). | `action`-værdi | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Ekstra felter, der bevares, fordi API'en har dem: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at` samt `entity_type` og `entity_status` fra entitetsjoinet. ## Afvigelser fra den tidligere eksport * **Rå IP er aldrig tilgængelig.** `/v1` eksponerer ikke rå klient-IP – det er privacy by design og ikke en afventende mapping. Forespørgslen tilføjer ikke en pladsholderkolonne for IP. * **Enhedstype er afledt, ikke rå.** `device_type` er en afledt enhedsklasse for klik-, indsendelses- og rapporteringshændelser. Observerede tokens omfatter `desktop`, `mobile`, `tablet` og `unknown`, men emitteren gemmer en fritekststreng – behandl den som åben tekst, ikke som en lukket enum. Den er null, når hændelsen ikke har nogen afledt klasse, og den rå `user_agent`-streng forbliver privat. * **"Email Sent" er `simulation.delivered`.** Brug dette token, når du filtrerer eller tæller udsendelser. Søg ikke efter en tidligere `email_sent`-streng. * **Modtagerens e-mail er et join, ikke et felt på hændelsen.** Rapporteringshændelsen udelader e-mail; forespørgslen gennemløber `/entities` for at udfylde den. * **De seneste 12 kalendermåneder**, ikke en varighed på 365 dage og ikke hele historikken. * **Langt format, ikke samlet.** Én række pr. interaktion, ikke ét resultat pr. person. ## Næste trin Legitimationsoplysninger, paginering og indlæsning af disse forespørgsler i Power BI eller Excel. Samlet oversigt pr. person over klik, legitimationsoplysninger og rapporteringer de seneste 12 måneder. Træningstilmeldinger på detaljeringsniveauet person × tildeling. Tildel `reporting:read` og `entity:read` på den nøgle, der opdaterer denne rapport. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.