> ## 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. # Utilisateurs les plus vulnérables > Recréez le cumul sur 12 mois des utilisateurs les plus vulnérables d'un fournisseur précédent à partir des résultats de simulation et des entités de /v1. Ce rapport est un cumul de la vulnérabilité par utilisateur sur 12 mois : une ligne par personne ayant reçu au moins une simulation au cours de la dernière année, avec les nombres et les taux de clics, d'identifiants saisis et de signalements, une séquence de clics en cours et une liste concaténée des 5 derniers résultats. La fenêtre couvre **12 mois civils** (minuit UTC le même jour du mois, douze mois plus tôt), et non une durée de 365 jours. Les interactions d'analyseurs automatisés ou de robots sont exclues des nombres de clics et d'identifiants saisis. Il s'agit d'un écart délibéré par rapport à l'exportation héritée. Consultez [Écarts par rapport à l'exportation héritée](#%C3%A9carts-par-rapport-%C3%A0-l-exportation-h%C3%A9rit%C3%A9e). La configuration, les identifiants, la pagination et la nouvelle tentative en cas de limite de débit sont identiques à ceux du [guide de connectivité Power BI / Excel](/fr-CA/developers/v1/powerbi). Ajoutez d'abord la requête partagée `Fn_FetchAll` : ce rapport l'appelle par son nom. ## Portées de clé requises | Portée | Utilisation | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (jointure du courriel et du nom d'affichage) | Ce rapport utilise la liste des résultats **opérationnelle** par personne, et non la famille d'aperçus de rapports. Une clé disposant uniquement de `reporting:read` ne peut pas appeler `GET /v1/simulation_results` (l'API renvoie `403`). Consultez [choisir la bonne granularité](/fr-CA/developers/v1/powerbi#choisir-la-bonne-granularit%C3%A9). ## Points de terminaison sources | Point de terminaison | Rôle | | - | - | | `GET /v1/simulation_results` | Résultat par destinataire. Il s'agit de la granularité des faits. | | `GET /v1/entities` | Résout `entity` → courriel / nom d'affichage. La ligne de résultat ne contient ni courriel ni nom d'affichage du destinataire (seulement `entity`). | Filtres autorisés sur la liste des résultats : `limit`, `page_token`, `simulation`, `entity`. Cette liste ne comporte aucun `delivered_after` / `start_date`, de sorte que les 12 derniers mois sont appliqués dans Power Query après le parcours complet. Champs utilisés pour chaque résultat : `id`, `simulation`, `entity`, `status`, `targeted_at`, `delivered_at`, `bounced_at`, `opened_at`, `clicked_at`, `attachment_opened_at`, `credential_submitted_at`, `reported_at`, `reported_before_interaction`, `bot_activity_detected`, `email_subject`, `sender_email`, `difficulty_level`, `created_at`, `updated_at`. ### Granularité Une ligne par entité ayant au moins un résultat avec `delivered_at` au cours des 12 derniers mois civils. Une personne ciblée mais jamais jointe n'apparaît pas. Les simulations multiples pour une même personne sont regroupées ici. Budget de requêtes : un parcours paginé de tous les résultats de simulation de l'organisation, plus un parcours des entités. Définissez toujours `limit = "500"`. ## Priorité des résultats (`last_5_assessments`) Chacun des cinq résultats livrés les plus récents (`delivered_at` décroissant) est résumé sous la forme `YYYY-MM-DD: `. Le premier horodatage correspondant l'emporte, en commençant par la priorité la plus élevée : | Priorité | Horodatage | Libellé du résultat | | - | - | - | | 1 | `credential_submitted_at` | `credential submitted` | | 2 | `clicked_at` | `clicked` | | 3 | `attachment_opened_at` | `attachment opened` | | 4 | `reported_at` | `reported` | | 5 | `opened_at` | `opened` | | 6 | `delivered_at` | `no action` | | 7 | `bounced_at` | `bounced` | Livré seulement correspond à `no action` (le message est arrivé; la personne n'a rien fait). Une personne qui a cliqué puis signalé correspond à `clicked` : le signalement ne l'emporte pas sur une interaction à risque dans cette liste. Les lignes signalées comme robots reçoivent tout de même un libellé de résultat à partir des horodatages présents; elles n'incrémentent simplement pas les nombres de clics et d'identifiants saisis. **Séquence de clics en cours :** parcourez ces mêmes résultats livrés du plus récent au plus ancien et comptez les lignes consécutives où `clicked_at` n'est pas nul **et** où `bot_activity_detected` n'est pas `true`. Arrêtez-vous au premier échec. ## Correspondance des colonnes Les noms de colonnes hérités proviennent de l'exportation de votre fournisseur précédent. Les champs `/v1` sont les noms de l'API publique; la requête en dérive les nombres et les taux. | Colonne héritée | Champ `/v1` ou dérivation | Colonne du rapport | | - | - | - | | Email | `Entity.email` (jointure sur `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Nombre de résultats où `delivered_at` n'est pas nul (inclut les lignes signalées comme robots) | `total_received` | | Clicks # | Nombre où `clicked_at` n'est pas nul **et** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Nombre où `credential_submitted_at` n'est pas nul **et** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Nombre où `reported_at` n'est pas nul (robots inclus — ce n'est pas un clic ni une saisie d'identifiants) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Résultats livrés consécutifs, du plus récent au plus ancien, sur lesquels la personne a cliqué (les robots l'interrompent) | `current_click_streak` | | Last 5 assessments | Les cinq résultats livrés les plus récents, séparés par `"; "` (consultez la [priorité](#priorité-des-résultats-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Absent de `/v1` | Omis, non mis à null | Clé de jointure conservée pour un modèle en étoile : `entity_id`. ## Écarts par rapport à l'exportation héritée * **L'activité des robots est exclue des nombres de clics et d'identifiants saisis.** L'exportation d'un fournisseur précédent comptait les interactions d'analyseurs automatisés ou de robots comme des clics et des saisies d'identifiants. Cette requête ne le fait pas. Un résultat avec `bot_activity_detected = true` demeure une simulation livrée : il est compté dans `total_received` et dans les agrégats de signalements, mais il est traité comme un non-clic et une non-saisie : il est omis de `clicks` / `credential_submissions` et il interrompt une séquence de clics en cours. Ne « corrigez » pas cela en comptant les robots pour correspondre à l'exportation héritée. * **Le signalement ne l'emporte pas sur un clic** dans `last_5_assessments`. Une personne qui a cliqué puis signalé est libellée `clicked`. * **Les champs supplémentaires de l'annuaire sont omis, non mis à null.** Le service et les champs similaires ne figurent pas dans `/v1`. * **Aucun filtre temporel côté serveur.** `GET /v1/simulation_results` n'a pas de `delivered_after`. La requête parcourt tous les résultats, puis ne conserve que `delivered_at` des 12 derniers mois civils. Une grande organisation ayant un long historique peut consommer une plus grande part du budget de débit par clé qu'une liste filtrée. ## Prochaines étapes Identifiants, pagination et chargement de ces requêtes dans Power BI ou Excel. Interactions d'hameçonnage au niveau des événements pour les 12 derniers mois. Inscriptions à la formation à la granularité personne × affectation. Accordez `simulation:read` et `entity:read` à la clé qui actualise ce rapport. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.