> ## 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. # Registre de phishing per correu electrònic > Recreeu el registre de phishing a nivell d'esdeveniment d'un proveïdor anterior a partir dels esdeveniments i les entitats de simulació dels informes de /v1. Aquest informe és un registre de phishing a nivell d'esdeveniment: una fila per cada interacció de simulació observada (data, acció, correu electrònic del destinatari, assumpte, remitent, dificultat). Es manté en format llarg: no condensa l'historial d'una persona en un únic resultat. La consulta inclou els **12 mesos naturals** més recents a `occurred_after` (mitjanit UTC del mateix dia del mes de fa dotze mesos, no una durada de 365 dies). La IP del client en brut mai no es troba a `/v1`: és una decisió de privadesa per disseny, no una assignació pendent. El tipus de dispositiu és una classe derivada a la fila de l'esdeveniment; el valor en brut de `user_agent` es manté privat. Vegeu [Divergències respecte a l'exportació anterior](#divergences-from-the-legacy-export). La configuració, les credencials, la paginació i els reintents per límit de peticions són els mateixos que a la [guia de connectivitat de Power BI / Excel](/ca/developers/v1/powerbi). Afegiu primer la consulta compartida `Fn_FetchAll`; aquest informe la crida pel nom. ## Required key scopes | Scope | Ús | | - | - | | `reporting:read` | `GET /v1/reporting/simulation_events` | | `entity:read` | `GET /v1/entities` (unió de correu electrònic i nom visible) | Una clau que només tingui concedit `simulation:read` no pot cridar l'endpoint d'esdeveniments dels informes (l'API retorna `403`). Vegeu [trieu el grau de detall adequat](/ca/developers/v1/powerbi#trieu-el-grau-de-detall-adequat). ## Source endpoints | Endpoint | Funció | | - | - | | `GET /v1/reporting/simulation_events` | Fet a nivell d'esdeveniment. El grau de detall és una interacció tipificada. `email_subject`, `sender_email`, `sender_domain` i `difficulty_tier` són en aquesta fila, de manera que la consulta no uneix resultats a nivell de campanya per a aquests camps. | | `GET /v1/entities` | Resol `entity_id` → correu electrònic / nom visible. L'esdeveniment de l'informe omet el correu electrònic del destinatari (una exclusió estricta al lector d'informes). Recórrer `/entities` és la manera d'emplenar la columna «email» de l'exportació anterior. | Filtres permesos a la llista d'esdeveniments (qualsevol altre retorna `400`): `limit`, `page_token`, `simulation`, `entity`, `event_type`, `occurred_after`. Aquesta família d'informes és un [conjunt de dades en versió preliminar](/ca/developers/v1/powerbi#conjunts-de-dades-de-previsualitzaci%C3%B3-de-reporting-phishing-per-persona). Podeu consultar l'esquema del conjunt de dades i les polítiques de dades a `GET /v1/reporting/datasets` i `GET /v1/reporting/datasets/simulation_events`. ### Grain Una fila per cada esdeveniment de simulació de l'informe. Una persona que ha obert i després ha fet clic al mateix missatge genera dues files. Els esdeveniments amb un `entity_id` nul (sense actor, destinatari ni participant objectiu) també apareixen; `email` és nul. La finestra de l'API s'amplia un minut; el límit exacte de `occurred_at >= WindowStart` es torna a aplicar localment perquè l'any més recent no depengui de si el servidor tracta `occurred_after` com a inclusiu o exclusiu. Pressupost de peticions: un recorregut paginat dels esdeveniments de la finestra, més un recorregut de les entitats. Definiu sempre `limit = "500"`. ## Column mapping Els noms de columna anteriors provenen de l'exportació del vostre proveïdor anterior. Els camps de `/v1` són els noms públics de l'API; la consulta n'anomena alguns amb àlies per a l'informe. | Columna anterior | Camp de `/v1` o derivació | Columna de l'informe | | - | - | - | | Date | `Event.occurred_at` (com a data; el valor en brut de `occurred_at` es conserva com a `datetimezone`) | `date` | | Action | `Event.event_type`: tokens tancats que s'indiquen més avall | `action` | | Email | `Entity.email` (unió per `entity_id`) | `email` | | Subject | `Event.email_subject` | `subject` | | From | `Event.sender_email` | `from` | | Difficulty | `Event.difficulty_tier`: nombre enter d'1 a 5, on 1 és el més fàcil i 5 el més difícil | `difficulty` | | Raw IP | Mai a `/v1` | Omesa, no establerta com a nul·la | | Device type | `Event.device_type`: classe derivada; nul si l'esdeveniment no té cap classe derivada | `device_type` | ### Action tokens `action` és el token tancat de l'informe. El «Email Sent» anterior es correspon amb `simulation.delivered` (`delivered` és el verb públic; el token a la xarxa és `simulation.delivered`). | Valor de `action` | | - | | `simulation.delivered` | | `simulation.opened` | | `simulation.link_clicked` | | `simulation.credentials_submitted` | | `simulation.attachment_opened` | | `simulation.reported` | | `simulation.bounced` | | `simulation.qr_scanned` | | `simulation.replied` | Camps addicionals que es mantenen perquè l'API els proporciona: `sender_domain`, `full_name`, `event_id`, `entity_id`, `simulation_id`, `occurred_at`, a més de `entity_type` i `entity_status` de la unió d'entitats. ## Divergences from the legacy export * **La IP en brut mai no està disponible.** `/v1` no exposarà la IP del client en brut: és una decisió de privadesa per disseny, no una assignació pendent. La consulta no afegeix cap columna d'IP de substitució. * **El tipus de dispositiu és derivat, no en brut.** `device_type` és una classe de dispositiu derivada per als esdeveniments de clic, enviament i informe. Els tokens observats inclouen `desktop`, `mobile`, `tablet` i `unknown`, però l'emissor desa una cadena de format lliure: tracteu-la com a text obert, no com una enumeració tancada. És nul·la quan l'esdeveniment no té cap classe derivada, i la cadena en brut de `user_agent` es manté privada. * **«Email Sent» és `simulation.delivered`.** Useu aquest token quan filtreu o compteu enviaments. No cerqueu la cadena `email_sent` anterior. * **El correu electrònic del destinatari és una unió, no un camp de l'esdeveniment.** L'esdeveniment de l'informe omet el correu electrònic; la consulta recorre `/entities` per emplenar-lo. * **12 mesos naturals més recents**, no una durada de 365 dies ni tot l'historial. * **Format llarg, no condensat.** Una fila per interacció, no un resultat per persona. ## Next steps Credencials, paginació i càrrega d'aquestes consultes a Power BI o Excel. Resum per persona de clics, credencials i informes dels últims 12 mesos. Inscripcions a Training amb el grau de detall persona × assignació. Concediu `reporting:read` i `entity:read` a la clau que actualitza aquest informe. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.