---
title: "Dossier du baromètre sur demande"
method: POST
path: "/barometre/dossiers"
---

# Dossier du baromètre sur demande

`POST /barometre/dossiers`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/barometre/dossiers`
- Auth: HTTP bearer

Un dossier du baromètre composé à partir d'une demande libre : le modèle propose un plan (classements, comparaisons, croisements, répartitions) sur le registre des mesures, sans voir aucun chiffre ; les sections sont calculées de façon déterministe sur l'édition ; la lecture rédigée par le modèle passe par un vérificateur qui retire toute phrase dont un chiffre n'est pas dans les faits calculés. Rend le plan, chaque section (faits, lecture vérifiée, lecture déterministe, graphique, tableau) et un lien signé vers le dossier sur pillr.fr. Les classements suivent les seuils de classement de l'édition. Demande hors du périmètre du baromètre : 400 parametres_invalides, rien n'est débité ; modèle indisponible : 503, crédits rendus. Coût : 20 crédits par appel réussi.

## Request body

- object
  - `question` string, required: La demande, en langage libre (ex. les passoires énergétiques en Bretagne).

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `edition` string, required
  - `titre` string, required
  - `chapo` string, required
  - `sections` object[], required
    - `type` string, required: classement, comparaison, croisement, repartition, agregat ou chiffre_cle.
    - `titre` string, required
    - `echelle` 'commune' | 'departement', required
    - `selection` string, required: La sélection, en clair.
    - `mesures` string[], required
    - `faits` string[], required: Les faits calculés sur l'édition, seule matière de la lecture.
    - `lecture` string[], required: Les phrases de la lecture rédigée par le modèle que le vérificateur a gardées.
    - `phrases_retirees` integer, required: Phrases de la lecture retirées par le vérificateur : un chiffre absent des faits.
    - `phrases` string[], required: La lecture déterministe, calculée sans modèle.
    - `graphique` unknown, required
    - `tableau` unknown, required
    - `vide` boolean, required
  - `lien_signe` string, nullable, required: Lien signé du dossier sur pillr.fr ; null si la signature n'a pas pu être faite.
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)