> ## Documentation Index
> Fetch the complete documentation index at: https://developers.0flaw.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Résultats d'une campagne, par employé

> Détail par destinataire (statut, dates d'ouverture/clic/soumission). Les adresses IP ne sont pas exposées (RGPD).



## OpenAPI

````yaml /openapi.json get /api/v1/campaigns/{id}/results
openapi: 3.1.0
info:
  title: API 0flaw
  version: 1.0.0
  description: >-
    API publique de 0flaw : provisionnez vos employés depuis votre SIRH/AD et
    recevez

    les événements de sécurité dans votre SIEM.


    ## Authentification

    Toutes les requêtes exigent une clé API, créée depuis votre dashboard

    (Réglages → Clés API). Transmettez-la dans l'en-tête `Authorization` :


    ```

    Authorization: Bearer 0flaw_live_xxxxxxxx

    ```


    L'en-tête `x-api-key` est également accepté. Une clé est **scopée à une
    seule

    entreprise** : elle ne peut jamais lire ni modifier les données d'une autre.


    ## Limites de débit

    600 requêtes par tranche de 15 minutes et par clé. Les en-têtes
    `RateLimit-*`

    accompagnent chaque réponse ; un dépassement renvoie `429`.


    ## Gestion des erreurs

    Fiez-vous au champ `code` (stable) et non au `message` (susceptible
    d'évoluer).
  contact:
    name: Support 0flaw
    url: https://app.0flaw.fr
servers:
  - url: https://api.0flaw.fr
    description: Production
security:
  - apiKey: []
tags:
  - name: Général
    description: Vérification d'accès et introspection de la clé
  - name: Employés
    description: 'Provisioning : création, mise à jour, désactivation, invitations'
  - name: Résultats
    description: Campagnes de phishing et leurs résultats (scope read:results)
  - name: Radar
    description: Risk scores par axe (scope read:scores)
  - name: Formations
    description: Statut des formations des employés (scope read:trainings)
paths:
  /api/v1/campaigns/{id}/results:
    get:
      tags:
        - Résultats
      summary: Résultats d'une campagne, par employé
      description: >-
        Détail par destinataire (statut, dates d'ouverture/clic/soumission). Les
        adresses IP ne sont pas exposées (RGPD).
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Identifiant de la campagne
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Numéro de page
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          description: Éléments par page (max 100)
      responses:
        '200':
          description: Résultats par employé
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        employe:
                          type: object
                          properties:
                            id:
                              type:
                                - string
                                - 'null'
                            nom:
                              type:
                                - string
                                - 'null'
                            prenom:
                              type:
                                - string
                                - 'null'
                            email:
                              type: string
                        statut:
                          type: string
                        date_envoi:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        date_ouverture:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        date_clic:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        date_soumission:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        nb_ouvertures:
                          type: integer
                        nb_clics:
                          type: integer
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
        '401':
          description: Clé API absente ou invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Clé API invalide ou révoquée
                code: API_KEY_INVALID
        '403':
          description: La clé ne porte pas le scope requis
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: 'Scope requis : write:employees'
                code: INSUFFICIENT_SCOPE
        '404':
          description: Campagne introuvable dans votre entreprise
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Campagne introuvable
                code: CAMPAIGN_NOT_FOUND
        '429':
          description: Quota de requêtes dépassé pour cette clé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Trop de requêtes, réessayez plus tard.
                code: RATE_LIMIT_EXCEEDED
      security:
        - apiKey:
            - read:results
components:
  schemas:
    Pagination:
      type: object
      properties:
        page:
          type: integer
        limit:
          type: integer
        total:
          type: integer
        total_pages:
          type: integer
        has_more:
          type: boolean
      required:
        - page
        - limit
        - total
        - total_pages
        - has_more
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Message lisible par un humain
        code:
          type: string
          description: Code stable, à utiliser pour la logique client
      required:
        - message
        - code
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        Clé API créée depuis le dashboard (Réglages → Clés API). L'en-tête
        `x-api-key: <clé>` est accepté en alternative à `Authorization: Bearer
        <clé>`.

````