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

# Private report exports

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## POST /reports/exports

Préparer un export privé d’une projection autorisée

`create_report_export`

Les objets publics de requête/définition sont limités à 64 Kio. Export privé piloté par le client d’une projection Explorer publique autorisée. Exige statistics:read et tous les droits actuels du dataset et des relations : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read. forms_submit exige aussi un UUID de formulaire actuel non supprimé dans la même organisation. Propriété privée de la clé API et de l’organisation, sans partage avec le personnel, restriction de campagne ni héritage administrateur. Employer le catalogue Explorer vivant ; aucun langage Mongo, champ personnalisé, document brut ou configuration de paiement réutilisable. scope=REQUESTED_PAGE exporte exactement la page demandée, au plus 200 lignes, pas tout le dataset ; totalMatches/hasMore signalent les autres pages. scope=AGGREGATE exporte l’agrégat existant borné à 30 groupes ; hasMore indique la troncature. Les pages séparées sont des observations vivantes, jamais un snapshot commun. Aucune nouvelle formule, agrégation monétaire, comparaison ou conversion. Les formats json/csv/xlsx/pdf partagent la projection scalaire autorisée. JSON conserve ses types ; CSV/XLSX/PDF conservent les nombres en unités brutes, indiquent les unités dans les libellés de champ et ajoutent une colonne devise pour chaque MONEY. Une valeur inconnue reste null dans JSON et vide dans CSV/XLSX et un tiret dans PDF, jamais zéro/EUR inventé. Les dates restent les chaînes ISO projetées. Les préfixes de formule sont neutralisés pour les tableurs. Réutilisation des renderers XLSX/PDF natifs ; un PDF non vide présente des fiches aux libellés complets, limité à 8 colonnes, devises incluses. La police Helvetica native ne rend que WinAnsi : un caractère non pris en charge (par exemple hébreu/arabe) refuse avec REPORT_EXPORT_PDF_GLYPH_UNSUPPORTED, sans translittération ni changement de format automatique. JSON/CSV/XLSX conservent Unicode. Fichier de 4 Mio maximum, aucun fichier partiel. COMPLETED peut être une autorisation et ne prouve pas le règlement bancaire. Le fichier est en base64 avec MIME, nom sûr, byteLength et sha256 ; le décoder sans inventer d’URL. Aucun lien de téléchargement serveur, email, prestataire ou partage public. Expiration 600 secondes après création avec identité d’exécution unique conservée. Aucun daemon, minuteur, réessai automatique ni vol de verrou. QUEUED exige execute explicite ; RUNNING reste verrouillé après incertitude ; SUCCEEDED/FAILED sont terminaux. GET ne lit jamais les lignes, ne rend, n’écrit, ne renouvelle ni ne nettoie. Les droits et le formulaire parent sont revalidés avant divulgation/exécution. Paramètres inconnus refusés. Exige aussi reports:write explicite. Fournir idempotencyKey (8–100 lettres/chiffres ASCII, underscore ou tiret) et request={format,kind,report}, kind=rows|aggregate correspondant à la requête Explorer publique. Validation des champs/droits/formulaire sans calcul ni rendu. Même clé/requête : même job ; entrées différentes : 409 STATISTICS_JOB_IDEMPOTENCY_CONFLICT. Acquittement durable positif exact avec w:1,j:true obligatoire. 503 STATISTICS_JOB_CREATION_UNCONFIRMED : inspecter/reprendre cette même clé avant un autre objet.

### Authentification

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

### Permissions requises

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{8,100}$"
          },
          "request": {
            "type": "object",
            "properties": {
              "format": {
                "type": "string",
                "enum": [
                  "json",
                  "csv",
                  "xlsx",
                  "pdf"
                ]
              },
              "kind": {
                "type": "string",
                "enum": [
                  "rows",
                  "aggregate"
                ]
              },
              "report": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/UnisoftRequest_729f4d152ef616c77bcd"
                  },
                  {
                    "$ref": "#/components/schemas/UnisoftRequest_411efe4dbeaae4a40e62"
                  }
                ]
              }
            },
            "required": [
              "format",
              "kind",
              "report"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "idempotencyKey",
          "request"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 201

```json
{
  "description": "Statut d’export privé et éventuel fichier base64 borné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportExportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Requête inconnue ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Principal ou droits source actuels refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Export privé, dataset ou formulaire indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de requête ou verrou d’exécution conservé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Export privé expiré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs invalides, limites de sortie/taille ou format non pris en charge.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Acquittement de stockage ou d’exécution incertain ; inspecter le même job.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [
    "reports:write"
  ],
  "x-unisoft-conditional-scopes": [
    "contacts:read",
    "paiements:read",
    "abonnements:read",
    "promesses:read",
    "forms:read",
    "forms_submit:read",
    "receipts:read"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /reports/exports/{jobId}

Lire le statut ou fichier figé d’un export privé

`get_report_export`

Les objets publics de requête/définition sont limités à 64 Kio. Export privé piloté par le client d’une projection Explorer publique autorisée. Exige statistics:read et tous les droits actuels du dataset et des relations : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read. forms_submit exige aussi un UUID de formulaire actuel non supprimé dans la même organisation. Propriété privée de la clé API et de l’organisation, sans partage avec le personnel, restriction de campagne ni héritage administrateur. Employer le catalogue Explorer vivant ; aucun langage Mongo, champ personnalisé, document brut ou configuration de paiement réutilisable. scope=REQUESTED_PAGE exporte exactement la page demandée, au plus 200 lignes, pas tout le dataset ; totalMatches/hasMore signalent les autres pages. scope=AGGREGATE exporte l’agrégat existant borné à 30 groupes ; hasMore indique la troncature. Les pages séparées sont des observations vivantes, jamais un snapshot commun. Aucune nouvelle formule, agrégation monétaire, comparaison ou conversion. Les formats json/csv/xlsx/pdf partagent la projection scalaire autorisée. JSON conserve ses types ; CSV/XLSX/PDF conservent les nombres en unités brutes, indiquent les unités dans les libellés de champ et ajoutent une colonne devise pour chaque MONEY. Une valeur inconnue reste null dans JSON et vide dans CSV/XLSX et un tiret dans PDF, jamais zéro/EUR inventé. Les dates restent les chaînes ISO projetées. Les préfixes de formule sont neutralisés pour les tableurs. Réutilisation des renderers XLSX/PDF natifs ; un PDF non vide présente des fiches aux libellés complets, limité à 8 colonnes, devises incluses. La police Helvetica native ne rend que WinAnsi : un caractère non pris en charge (par exemple hébreu/arabe) refuse avec REPORT_EXPORT_PDF_GLYPH_UNSUPPORTED, sans translittération ni changement de format automatique. JSON/CSV/XLSX conservent Unicode. Fichier de 4 Mio maximum, aucun fichier partiel. COMPLETED peut être une autorisation et ne prouve pas le règlement bancaire. Le fichier est en base64 avec MIME, nom sûr, byteLength et sha256 ; le décoder sans inventer d’URL. Aucun lien de téléchargement serveur, email, prestataire ou partage public. Expiration 600 secondes après création avec identité d’exécution unique conservée. Aucun daemon, minuteur, réessai automatique ni vol de verrou. QUEUED exige execute explicite ; RUNNING reste verrouillé après incertitude ; SUCCEEDED/FAILED sont terminaux. GET ne lit jamais les lignes, ne rend, n’écrit, ne renouvelle ni ne nettoie. Les droits et le formulaire parent sont revalidés avant divulgation/exécution. Paramètres inconnus refusés. Lit le job privé et son fichier terminal seulement pour SUCCEEDED. FAILED contient un code stable, aucun fichier partiel. 404 couvre aussi une autre clé/organisation. 410 STATISTICS_JOB_EXPIRED interdit le fichier sans renouvellement ni suppression. Après perte de connexion, inspecter ce job ; RUNNING reste verrouillé, sans reprise automatique. reports:write inutile en lecture.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "jobId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé d’export rendu par create_report_export."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Statut d’export privé et éventuel fichier base64 borné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportExportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Requête inconnue ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Principal ou droits source actuels refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Export privé, dataset ou formulaire indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de requête ou verrou d’exécution conservé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Export privé expiré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs invalides, limites de sortie/taille ou format non pris en charge.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Acquittement de stockage ou d’exécution incertain ; inspecter le même job.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

### OpenAPI

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

## POST /reports/exports/{jobId}/execute

Produire explicitement une fois un export privé en attente

`execute_report_export`

Les objets publics de requête/définition sont limités à 64 Kio. Export privé piloté par le client d’une projection Explorer publique autorisée. Exige statistics:read et tous les droits actuels du dataset et des relations : contacts/interactions=contacts:read, paiements=paiements:read, abonnements=abonnements:read, promesses=promesses:read, forms_submit=forms:read ET forms_submit:read, cerfas=receipts:read. forms_submit exige aussi un UUID de formulaire actuel non supprimé dans la même organisation. Propriété privée de la clé API et de l’organisation, sans partage avec le personnel, restriction de campagne ni héritage administrateur. Employer le catalogue Explorer vivant ; aucun langage Mongo, champ personnalisé, document brut ou configuration de paiement réutilisable. scope=REQUESTED_PAGE exporte exactement la page demandée, au plus 200 lignes, pas tout le dataset ; totalMatches/hasMore signalent les autres pages. scope=AGGREGATE exporte l’agrégat existant borné à 30 groupes ; hasMore indique la troncature. Les pages séparées sont des observations vivantes, jamais un snapshot commun. Aucune nouvelle formule, agrégation monétaire, comparaison ou conversion. Les formats json/csv/xlsx/pdf partagent la projection scalaire autorisée. JSON conserve ses types ; CSV/XLSX/PDF conservent les nombres en unités brutes, indiquent les unités dans les libellés de champ et ajoutent une colonne devise pour chaque MONEY. Une valeur inconnue reste null dans JSON et vide dans CSV/XLSX et un tiret dans PDF, jamais zéro/EUR inventé. Les dates restent les chaînes ISO projetées. Les préfixes de formule sont neutralisés pour les tableurs. Réutilisation des renderers XLSX/PDF natifs ; un PDF non vide présente des fiches aux libellés complets, limité à 8 colonnes, devises incluses. La police Helvetica native ne rend que WinAnsi : un caractère non pris en charge (par exemple hébreu/arabe) refuse avec REPORT_EXPORT_PDF_GLYPH_UNSUPPORTED, sans translittération ni changement de format automatique. JSON/CSV/XLSX conservent Unicode. Fichier de 4 Mio maximum, aucun fichier partiel. COMPLETED peut être une autorisation et ne prouve pas le règlement bancaire. Le fichier est en base64 avec MIME, nom sûr, byteLength et sha256 ; le décoder sans inventer d’URL. Aucun lien de téléchargement serveur, email, prestataire ou partage public. Expiration 600 secondes après création avec identité d’exécution unique conservée. Aucun daemon, minuteur, réessai automatique ni vol de verrou. QUEUED exige execute explicite ; RUNNING reste verrouillé après incertitude ; SUCCEEDED/FAILED sont terminaux. GET ne lit jamais les lignes, ne rend, n’écrit, ne renouvelle ni ne nettoie. Les droits et le formulaire parent sont revalidés avant divulgation/exécution. Paramètres inconnus refusés. Exige aussi reports:write et un objet vide. Validation des droits/formulaire puis claim durable CAS propriété scalaire/révision avant une seule lecture publique et un rendu. Une répétition terminale restitue le fichier figé. RUNNING : 409 STATISTICS_JOB_EXECUTION_LOCKED. 503 STATISTICS_JOB_EXECUTION_UNCONFIRMED ou STATISTICS_JOB_FINALIZATION_UNCONFIRMED : inspecter GET, sans relancer ni déduire automatiquement une absence de fichier. Examiner state même dans une enveloppe réussie. Erreurs source, limites ou renderer : FAILED terminal et code stable. Aucun effet financier autorisé.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "jobId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID privé d’export rendu par create_report_export."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Statut d’export privé et éventuel fichier base64 borné.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReportExportResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Requête inconnue ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification requise.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Principal ou droits source actuels refusés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Export privé, dataset ou formulaire indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Conflit de requête ou verrou d’exécution conservé.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 410

```json
{
  "description": "Export privé expiré.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "Champs invalides, limites de sortie/taille ou format non pris en charge.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "Acquittement de stockage ou d’exécution incertain ; inspecter le même job.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StatisticsJobError"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-scope": "statistics:read",
  "x-unisoft-additional-scopes": [
    "reports:write"
  ],
  "x-unisoft-conditional-scopes": [
    "contacts:read",
    "paiements:read",
    "abonnements:read",
    "promesses:read",
    "forms:read",
    "forms_submit:read",
    "receipts:read"
  ],
  "x-unisoft-mcp": {
    "category": "write",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "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
      },
      "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
      },
      "ReportExportResponse": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/ReportExportJob"
          }
        },
        "required": [
          "success",
          "data"
        ]
      },
      "ReportExportJob": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "QUEUED",
              "RUNNING",
              "SUCCEEDED",
              "FAILED"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time"
          },
          "executionModel": {
            "type": "string",
            "enum": [
              "CLIENT_DRIVEN_ONCE"
            ]
          },
          "canExecute": {
            "type": "boolean"
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReportExportFile"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ]
          }
        },
        "required": [
          "id",
          "state",
          "createdAt",
          "expiresAt",
          "startedAt",
          "finishedAt",
          "executionModel",
          "canExecute",
          "error",
          "result"
        ]
      },
      "ReportExportFile": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "format": {
            "type": "string",
            "enum": [
              "json",
              "csv",
              "xlsx",
              "pdf"
            ]
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "application/json",
              "text/csv",
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
              "application/pdf"
            ]
          },
          "fileName": {
            "type": "string",
            "enum": [
              "unisoft-report.json",
              "unisoft-report.csv",
              "unisoft-report.xlsx",
              "unisoft-report.pdf"
            ]
          },
          "encoding": {
            "type": "string",
            "enum": [
              "base64"
            ]
          },
          "data": {
            "type": "string",
            "maxLength": 5600000
          },
          "sha256": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "byteLength": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4194304
          },
          "scope": {
            "type": "string",
            "enum": [
              "REQUESTED_PAGE",
              "AGGREGATE"
            ]
          },
          "rowCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 200
          },
          "page": {
            "type": "integer",
            "nullable": true,
            "minimum": 1,
            "maximum": 500
          },
          "pageSize": {
            "type": "integer",
            "nullable": true,
            "minimum": 1,
            "maximum": 200
          },
          "totalMatches": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "hasMore": {
            "type": "boolean"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceComputedAt": {
            "type": "string",
            "nullable": true,
            "enum": [
              null
            ]
          },
          "freshness": {
            "type": "string",
            "enum": [
              "LIVE_QUERY"
            ]
          },
          "consistentSnapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "units": {
            "type": "string",
            "enum": [
              "OWNER_RAW_UNITS"
            ]
          }
        },
        "required": [
          "format",
          "mimeType",
          "fileName",
          "encoding",
          "data",
          "sha256",
          "byteLength",
          "scope",
          "rowCount",
          "page",
          "pageSize",
          "totalMatches",
          "hasMore",
          "readAt",
          "sourceComputedAt",
          "freshness",
          "consistentSnapshot",
          "units"
        ]
      },
      "StatisticsJobError": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
