**Versions de l’API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=fr)

# Rapports de l’explorateur

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

Lire des rapports bornés avec l’explorateur existant, avec vérification indépendante des permissions des jeux de données et des relations.

## Opérations

## GET /explorer/reports/datasets

Découvrir les jeux de données autorisés pour les rapports de l’explorateur

`list_explorer_report_datasets`

Requiert statistics:read ainsi que chaque autorisation de source indiquée pour le jeu de données choisi et chaque relation utilisée ; ces autorisations sont de nouveau vérifiées à l’exécution. Correspondance des jeux de données : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms_submit:read ET forms:read, cerfas=receipts:read. Une référence à une source ne confère jamais les droits d’une autre source. Toute restriction de collecte, y compris une liste vide, est refusée avec EXPLORER_CAMPAIGN_SCOPE_UNSUPPORTED : le propriétaire actuel de l’explorateur ne peut pas l’appliquer à toutes les relations. Utilise l’organisation authentifiée et les permissions de lecture du propriétaire sans identité d’administrateur. Pour exécuter forms_submit, formId doit identifier un formulaire actuel non supprimé de la même organisation ; une référence historique de soumission ne donne pas accès à son parent. Un formulaire absent, supprimé ou étranger renvoie 404 EXPLORER_FORM_NOT_FOUND : choisir un formulaire actuel de cette organisation avant de réessayer. Aucun pipeline, chemin de base de données, collection, JavaScript, expression libre, champ personnalisé, moyen de paiement réutilisable ni configuration privée n’est accepté ou renvoyé. Aucune écriture métier, sauvegarde, exportation, émission de document facturable, requête à un prestataire ni initialisation persistante ; l’authentification peut mettre à jour la télémétrie d’utilisation de la clé. Renvoie uniquement les jeux de données lisibles par la clé. Un catalogue vide est valide. Aucun paramètre de requête ni corps non vide n’est accepté. Consulter le détail du jeu de données avant de construire un rapport ; ce catalogue est distinct de celui des définitions statistiques et ne prétend pas permettre de retrouver les lignes sources d’une statistique.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat autorisé du rapport de l’explorateur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportDatasetsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre, champ, opérateur, type de valeur, limite ou contexte de formulaire invalide ou inconnu. Affiner la demande à partir du catalogue de jeux de données autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation statistics:read absente, organisation invalide ou clé limitée à des collectes. Le propriétaire actuel ne peut pas exécuter en sécurité les rapports limités à des collectes.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Jeu de données inconnu ou non autorisé par les permissions de source de la clé ; formulaire obligatoire absent, supprimé ou hors de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Le propriétaire a refusé ce rapport ; aucun résultat partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Le propriétaire est indisponible ou sa requête bornée n’a pas abouti. Aucune mutation métier n’a été tentée ; réduire le rapport avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /explorer/reports/datasets/{dataset}

Consulter les champs et relations autorisés d’un jeu de données de l’explorateur

`get_explorer_report_dataset`

Requiert statistics:read ainsi que chaque autorisation de source indiquée pour le jeu de données choisi et chaque relation utilisée ; ces autorisations sont de nouveau vérifiées à l’exécution. Correspondance des jeux de données : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms_submit:read ET forms:read, cerfas=receipts:read. Une référence à une source ne confère jamais les droits d’une autre source. Toute restriction de collecte, y compris une liste vide, est refusée avec EXPLORER_CAMPAIGN_SCOPE_UNSUPPORTED : le propriétaire actuel de l’explorateur ne peut pas l’appliquer à toutes les relations. Utilise l’organisation authentifiée et les permissions de lecture du propriétaire sans identité d’administrateur. Pour exécuter forms_submit, formId doit identifier un formulaire actuel non supprimé de la même organisation ; une référence historique de soumission ne donne pas accès à son parent. Un formulaire absent, supprimé ou étranger renvoie 404 EXPLORER_FORM_NOT_FOUND : choisir un formulaire actuel de cette organisation avant de réessayer. Aucun pipeline, chemin de base de données, collection, JavaScript, expression libre, champ personnalisé, moyen de paiement réutilisable ni configuration privée n’est accepté ou renvoyé. Aucune écriture métier, sauvegarde, exportation, émission de document facturable, requête à un prestataire ni initialisation persistante ; l’authentification peut mettre à jour la télémétrie d’utilisation de la clé. Présente uniquement les champs scalaires logiques sûrs et les relations autorisées, avec leurs opérateurs de filtre, leurs capacités de tri et de regroupement et les unités monétaires brutes. Les relations un-à-plusieurs exposent seulement certains agrégats de compte et de première/dernière date du propriétaire, jamais les documents imbriqués. Les métadonnées privées et les chemins de base de données sont omis. forms_submit propose des lignes de soumission dans un formulaire dont l’UUID est obligatoire ; les réponses dynamiques et les lignes par produit, participant ou place ne sont pas exposées. Aucun paramètre de requête ni corps non vide n’est accepté.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Paramètres

```json
{
  "name": "dataset",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "contacts",
      "interactions",
      "paiements",
      "abonnements",
      "promesses",
      "forms_submit",
      "cerfas"
    ]
  },
  "description": "Identifiant de jeu de données du catalogue autorisé de l’explorateur."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat autorisé du rapport de l’explorateur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportDatasetResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre, champ, opérateur, type de valeur, limite ou contexte de formulaire invalide ou inconnu. Affiner la demande à partir du catalogue de jeux de données autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation statistics:read absente, organisation invalide ou clé limitée à des collectes. Le propriétaire actuel ne peut pas exécuter en sécurité les rapports limités à des collectes.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Jeu de données inconnu ou non autorisé par les permissions de source de la clé ; formulaire obligatoire absent, supprimé ou hors de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Le propriétaire a refusé ce rapport ; aucun résultat partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Le propriétaire est indisponible ou sa requête bornée n’a pas abouti. Aucune mutation métier n’a été tentée ; réduire le rapport avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /explorer/reports/run

Lire une page bornée d’un rapport autorisé de l’explorateur

`run_explorer_report`

Requiert statistics:read ainsi que chaque autorisation de source indiquée pour le jeu de données choisi et chaque relation utilisée ; ces autorisations sont de nouveau vérifiées à l’exécution. Correspondance des jeux de données : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms_submit:read ET forms:read, cerfas=receipts:read. Une référence à une source ne confère jamais les droits d’une autre source. Toute restriction de collecte, y compris une liste vide, est refusée avec EXPLORER_CAMPAIGN_SCOPE_UNSUPPORTED : le propriétaire actuel de l’explorateur ne peut pas l’appliquer à toutes les relations. Utilise l’organisation authentifiée et les permissions de lecture du propriétaire sans identité d’administrateur. Pour exécuter forms_submit, formId doit identifier un formulaire actuel non supprimé de la même organisation ; une référence historique de soumission ne donne pas accès à son parent. Un formulaire absent, supprimé ou étranger renvoie 404 EXPLORER_FORM_NOT_FOUND : choisir un formulaire actuel de cette organisation avant de réessayer. Aucun pipeline, chemin de base de données, collection, JavaScript, expression libre, champ personnalisé, moyen de paiement réutilisable ni configuration privée n’est accepté ou renvoyé. Aucune écriture métier, sauvegarde, exportation, émission de document facturable, requête à un prestataire ni initialisation persistante ; l’authentification peut mettre à jour la télémétrie d’utilisation de la clé. Fournir dataset et 1–40 champs fields uniques de son catalogue ; les filtres facultatifs sont combinés par ET, chacun avec un opérateur autorisé et des valeurs scalaires. Les filtres numériques exigent des nombres JSON dans les unités brutes du propriétaire ; les montants sont en unités mineures pour les paiements/abonnements et majeures pour les promesses. Les dates calendaires utilisent YYYY-MM-DD et les filtres de date et heure des instants ISO avec décalage explicite ; aucune période ni aucun fuseau de rapport implicite n’est appliqué. Les opérateurs de vide/booléens exigent values:[], between exactement deux valeurs. Au plus 20 filtres, 20 valeurs par filtre et 4 clés de tri ; id départage les égalités de façon stable. page=1..500 et pageSize=1..200 sont des entiers. Seules les cellules demandées et leurs devises sont projetées ; les cellules historiques invalides restent null. Le jeu de données paiements du propriétaire inclut seulement les enregistrements COMPLETED, qui peuvent correspondre à une autorisation Axepta avant capture ; ce n’est pas un relevé de règlement bancaire. Les champs calculés de solde de promesse en cache sont exclus. readAt est l’heure d’observation de la réponse, sourceComputedAt reste null et LIVE_QUERY décrit l’exécution en base sans attester la fraîcheur des champs sources figés. La page et le total proviennent de requêtes séparées et ne constituent pas un instantané cohérent unique. Chaque agrégation du propriétaire est limitée à 15 secondes. Les paramètres inconnus et les paramètres de requête sont refusés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_729f4d152ef616c77bcd"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat autorisé du rapport de l’explorateur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportRunResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre, champ, opérateur, type de valeur, limite ou contexte de formulaire invalide ou inconnu. Affiner la demande à partir du catalogue de jeux de données autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation statistics:read absente, organisation invalide ou clé limitée à des collectes. Le propriétaire actuel ne peut pas exécuter en sécurité les rapports limités à des collectes.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Jeu de données inconnu ou non autorisé par les permissions de source de la clé ; formulaire obligatoire absent, supprimé ou hors de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Le propriétaire a refusé ce rapport ; aucun résultat partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Le propriétaire est indisponible ou sa requête bornée n’a pas abouti. Aucune mutation métier n’a été tentée ; réduire le rapport avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /explorer/reports/aggregate

Agréger un rapport autorisé de l’explorateur selon un champ

`aggregate_explorer_report`

Requiert statistics:read ainsi que chaque autorisation de source indiquée pour le jeu de données choisi et chaque relation utilisée ; ces autorisations sont de nouveau vérifiées à l’exécution. Correspondance des jeux de données : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms_submit:read ET forms:read, cerfas=receipts:read. Une référence à une source ne confère jamais les droits d’une autre source. Toute restriction de collecte, y compris une liste vide, est refusée avec EXPLORER_CAMPAIGN_SCOPE_UNSUPPORTED : le propriétaire actuel de l’explorateur ne peut pas l’appliquer à toutes les relations. Utilise l’organisation authentifiée et les permissions de lecture du propriétaire sans identité d’administrateur. Pour exécuter forms_submit, formId doit identifier un formulaire actuel non supprimé de la même organisation ; une référence historique de soumission ne donne pas accès à son parent. Un formulaire absent, supprimé ou étranger renvoie 404 EXPLORER_FORM_NOT_FOUND : choisir un formulaire actuel de cette organisation avant de réessayer. Aucun pipeline, chemin de base de données, collection, JavaScript, expression libre, champ personnalisé, moyen de paiement réutilisable ni configuration privée n’est accepté ou renvoyé. Aucune écriture métier, sauvegarde, exportation, émission de document facturable, requête à un prestataire ni initialisation persistante ; l’authentification peut mettre à jour la télémétrie d’utilisation de la clé. Utilise l’ensemble du jeu de données filtré du propriétaire, indépendamment de toute page. operation=count|sum|avg|min|max est explicite ; count interdit field et les autres opérations exigent un champ NUMBER racine/calculé dont numericAggregate:true. Les métriques MONEY et de relation ne sont pas prises en charge et ne sont jamais converties silencieusement. groupBy facultatif désigne un champ scalaire regroupable, sans regroupement de dates, expression libre ni regroupement sur plusieurs axes. Au plus 30 groupes, triés par valeur décroissante du propriétaire puis par compte et groupe ; truncated indique des groupes supplémentaires. Sans groupBy, items est vide et value/valueCount portent l’agrégat global ; avec regroupement, value/valueCount valent null. Les agrégats numériques ignorent les valeurs sources non numériques ; count compte toutes les lignes sources correspondantes et non les valeurs numériques. Un agrégat numérique vide du propriétaire peut valoir zéro avec valueCount=0 ; ce n’est pas une valeur source nulle observée. Mêmes règles de filtre, d’unité brute et d’UUID obligatoire de formulaire que run_explorer_report. readAt est l’heure d’observation, sourceComputedAt est inconnu et consistentSnapshot vaut false car compte et agrégat sont lus séparément. Chaque agrégation du propriétaire est limitée à 15 secondes. Les paramètres inconnus et les paramètres de requête sont refusés.

### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Permissions requises

```json
{
  "accepted": "statistics:read",
  "additional": []
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_411efe4dbeaae4a40e62"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat autorisé du rapport de l’explorateur.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportAggregateResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre, champ, opérateur, type de valeur, limite ou contexte de formulaire invalide ou inconnu. Affiner la demande à partir du catalogue de jeux de données autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation statistics:read absente, organisation invalide ou clé limitée à des collectes. Le propriétaire actuel ne peut pas exécuter en sécurité les rapports limités à des collectes.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Jeu de données inconnu ou non autorisé par les permissions de source de la clé ; formulaire obligatoire absent, supprimé ou hors de l’organisation.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Le propriétaire a refusé ce rapport ; aucun résultat partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Le propriétaire est indisponible ou sa requête bornée n’a pas abouti. Aucune mutation métier n’a été tentée ; réduire le rapport avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ExplorerReportError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [],
  "x-unisoft-scopes-by-dataset": {
    "contacts": [
      "contacts:read"
    ],
    "interactions": [
      "contacts:read"
    ],
    "paiements": [
      "paiements:read"
    ],
    "abonnements": [
      "abonnements:read"
    ],
    "promesses": [
      "promesses:read"
    ],
    "forms_submit": [
      "forms_submit:read",
      "forms:read"
    ],
    "cerfas": [
      "receipts:read"
    ]
  },
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "ExplorerReportDatasetsResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExplorerReportDataset"
            }
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ExplorerReportDataset": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "label": {
            "type": "string"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requiresFormId": {
            "type": "boolean"
          },
          "rowMode": {
            "type": "string",
            "enum": [
              "root",
              "submission"
            ]
          }
        },
        "required": [
          "id",
          "label",
          "requiredScopes",
          "requiresFormId",
          "rowMode"
        ]
      },
      "ExplorerReportError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      },
      "ExplorerReportDatasetResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ExplorerReportDatasetDetail"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ExplorerReportDatasetDetail": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "label": {
            "type": "string"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requiresFormId": {
            "type": "boolean"
          },
          "rowMode": {
            "type": "string",
            "enum": [
              "root",
              "submission"
            ]
          },
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExplorerReportField"
            }
          },
          "relations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExplorerReportRelation"
            }
          },
          "limits": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "columns": {
                "type": "integer",
                "enum": [
                  40
                ]
              },
              "filters": {
                "type": "integer",
                "enum": [
                  20
                ]
              },
              "sorters": {
                "type": "integer",
                "enum": [
                  4
                ]
              },
              "values": {
                "type": "integer",
                "enum": [
                  20
                ]
              },
              "valueLength": {
                "type": "integer",
                "enum": [
                  500
                ]
              },
              "pageSize": {
                "type": "integer",
                "enum": [
                  200
                ]
              },
              "page": {
                "type": "integer",
                "enum": [
                  500
                ]
              },
              "groups": {
                "type": "integer",
                "enum": [
                  30
                ]
              }
            },
            "required": [
              "columns",
              "filters",
              "sorters",
              "values",
              "valueLength",
              "pageSize",
              "page",
              "groups"
            ]
          },
          "aggregateOperations": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "count",
                "sum",
                "avg",
                "min",
                "max"
              ]
            }
          }
        },
        "required": [
          "id",
          "label",
          "requiredScopes",
          "requiresFormId",
          "rowMode",
          "fields",
          "relations",
          "limits",
          "aggregateOperations"
        ]
      },
      "ExplorerReportField": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
          },
          "type": {
            "type": "string",
            "enum": [
              "TEXT",
              "NUMBER",
              "MONEY",
              "DATE",
              "DATETIME",
              "BOOL",
              "ENUM",
              "REF"
            ]
          },
          "label": {
            "type": "string"
          },
          "filterable": {
            "type": "boolean"
          },
          "sortable": {
            "type": "boolean"
          },
          "groupable": {
            "type": "boolean"
          },
          "numericAggregate": {
            "type": "boolean"
          },
          "operators": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "unit": {
            "type": "string",
            "nullable": true,
            "enum": [
              "NUMBER",
              "MINOR_CURRENCY_UNIT",
              "MAJOR_CURRENCY_UNIT",
              null
            ]
          }
        },
        "required": [
          "field",
          "type",
          "label",
          "filterable",
          "sortable",
          "groupable",
          "numericAggregate",
          "operators",
          "unit"
        ]
      },
      "ExplorerReportRelation": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "dataset": {
            "type": "string"
          },
          "cardinality": {
            "type": "string",
            "enum": [
              "one",
              "many"
            ]
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "dataset",
          "cardinality",
          "requiredScopes"
        ]
      },
      "UnisoftRequest_729f4d152ef616c77bcd": {
        "type": "object",
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "contains",
                    "equals",
                    "startsWith",
                    "endsWith",
                    "in",
                    "notIn",
                    "eq",
                    "neq",
                    "gt",
                    "gte",
                    "lt",
                    "lte",
                    "between",
                    "before",
                    "after",
                    "isTrue",
                    "isFalse",
                    "isEmpty",
                    "isNotEmpty"
                  ]
                },
                "values": {
                  "type": "array",
                  "maxItems": 20,
                  "items": {
                    "oneOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "number"
                      }
                    ]
                  }
                }
              },
              "required": [
                "field",
                "op",
                "values"
              ],
              "additionalProperties": false
            }
          },
          "fields": {
            "type": "array",
            "minItems": 1,
            "maxItems": 40,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 180,
              "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
            }
          },
          "sort": {
            "type": "array",
            "maxItems": 4,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "order": {
                  "type": "string",
                  "enum": [
                    "asc",
                    "desc"
                  ]
                }
              },
              "required": [
                "field",
                "order"
              ],
              "additionalProperties": false
            }
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 1
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          }
        },
        "required": [
          "dataset",
          "fields"
        ],
        "additionalProperties": false
      },
      "ExplorerReportRunResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ExplorerReportRunResult"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ExplorerReportRunResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string"
          },
          "columns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExplorerReportField"
            }
          },
          "rows": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/ExplorerReportRow"
            }
          },
          "total": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "page": {
            "type": "integer"
          },
          "pageSize": {
            "type": "integer"
          },
          "hasMore": {
            "type": "boolean"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceComputedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "freshness": {
            "type": "string",
            "enum": [
              "LIVE_QUERY"
            ]
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "dataset",
          "columns",
          "rows",
          "total",
          "page",
          "pageSize",
          "hasMore",
          "readAt",
          "sourceComputedAt",
          "freshness",
          "consistentSnapshot"
        ]
      },
      "ExplorerReportRow": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "values": {
            "type": "object",
            "additionalProperties": {
              "oneOf": [
                {
                  "type": "string",
                  "maxLength": 2000,
                  "nullable": true
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                }
              ]
            },
            "description": "Uniquement les identifiants logiques de champs demandés. Les valeurs conservent les unités brutes du propriétaire. Les valeurs stockées non prises en charge ou invalides valent null ; aucun document brut ni instantané imbriqué n’est renvoyé."
          },
          "currencies": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "nullable": true,
              "pattern": "^[a-z]{3}$"
            },
            "description": "Devise de chaque champ MONEY sélectionné, ou null si elle est indisponible. Aucune devise d’organisation n’est inventée."
          }
        },
        "required": [
          "values",
          "currencies"
        ]
      },
      "UnisoftRequest_411efe4dbeaae4a40e62": {
        "type": "object",
        "properties": {
          "dataset": {
            "type": "string",
            "enum": [
              "contacts",
              "interactions",
              "paiements",
              "abonnements",
              "promesses",
              "forms_submit",
              "cerfas"
            ]
          },
          "formId": {
            "type": "string",
            "format": "uuid",
            "description": "Obligatoire seulement pour forms_submit, dont la granularité prise en charge est submission. Les autres jeux de données refusent formId."
          },
          "filters": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 180,
                  "description": "Identifiant logique exact de champ annoncé dans le catalogue autorisé de ce jeu de données ; jamais un chemin de base de données ni une expression."
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "contains",
                    "equals",
                    "startsWith",
                    "endsWith",
                    "in",
                    "notIn",
                    "eq",
                    "neq",
                    "gt",
                    "gte",
                    "lt",
                    "lte",
                    "between",
                    "before",
                    "after",
                    "isTrue",
                    "isFalse",
                    "isEmpty",
                    "isNotEmpty"
                  ]
                },
                "values": {
                  "type": "array",
                  "maxItems": 20,
                  "items": {
                    "oneOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "number"
                      }
                    ]
                  }
                }
              },
              "required": [
                "field",
                "op",
                "values"
              ],
              "additionalProperties": false
            }
          },
          "operation": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "avg",
              "min",
              "max"
            ]
          },
          "field": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Obligatoire pour sum/avg/min/max, interdit pour count. Seul un champ NUMBER racine ou calculé avec numericAggregate:true est accepté ; les métriques MONEY et de relation ne sont pas prises en charge."
          },
          "groupBy": {
            "type": "string",
            "minLength": 1,
            "maxLength": 180,
            "description": "Champ regroupable unique facultatif. L’omettre pour une valeur globale. Aucun regroupement sur plusieurs axes ou par intervalle de date, aucune expression ni agrégation monétaire n’est accepté."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "default": 12
          }
        },
        "required": [
          "dataset",
          "operation"
        ],
        "additionalProperties": false
      },
      "ExplorerReportAggregateResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ExplorerReportAggregateResult"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ExplorerReportAggregateResult": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "dataset": {
            "type": "string"
          },
          "operation": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "avg",
              "min",
              "max"
            ]
          },
          "field": {
            "type": "string",
            "nullable": true
          },
          "groupBy": {
            "type": "string",
            "nullable": true
          },
          "items": {
            "type": "array",
            "maxItems": 30,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "group": {
                  "oneOf": [
                    {
                      "type": "string",
                      "maxLength": 2000,
                      "nullable": true
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    }
                  ]
                },
                "count": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "nullable": true
                },
                "value": {
                  "type": "number",
                  "nullable": true
                }
              },
              "required": [
                "group",
                "count",
                "value"
              ]
            }
          },
          "value": {
            "type": "number",
            "nullable": true
          },
          "count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "valueCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "truncated": {
            "type": "boolean"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceComputedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "freshness": {
            "type": "string",
            "enum": [
              "LIVE_QUERY"
            ]
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        },
        "required": [
          "dataset",
          "operation",
          "field",
          "groupBy",
          "items",
          "value",
          "count",
          "valueCount",
          "truncated",
          "readAt",
          "sourceComputedAt",
          "freshness",
          "consistentSnapshot"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
