Analyser un document versé — l'analyseur propose, le référentiel dispose.

POST

/tenants/{tenant}/documents/{document}/analyses

curl --request POST \
  --url https://example.com/tenants/example/documents/example/analyses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "analyse": "example", "analyse_le": "2026-04-15" }'

Le temps 2 : l’analyseur (un adaptateur outillé, versionné — jamais une autorité) lit le contenu archivé et produit une proposition de gestes d’administration, chacun localisé dans le document et rapproché de l’état courant (nouveau, écart, ou conforme — le conforme est un constat, il ne s’examine pas). Rien n’est appliqué. Ré-analyser produit une analyse de plus — jamais l’écrasement d’une précédente.

Autorisations

• authentification
  instruments:administration

Paramètres

Paramètres (path)

tenant

required

string

>= 1 characters

Le teneur de compte — la muraille, aucun geste ne la franchit.

document

required

string

>= 1 characters

La référence du document chez ce tenant.

Corps de la requête^required

Media typeapplication/json

object

analyse

required

L’identifiant de l’analyse — unique chez ce tenant.

string

>= 1 characters

analyse_le

required

La date de l’analyse — les dates viennent de l’appelant.

string format: date

Example^generated

{
  "analyse": "example",
  "analyse_le": "2026-04-15"
}

Réponses

201

L’analyse est produite et enregistrée — ses gestes attendent l’examen.

Media typeapplication/json

object

tenant

required

string

analyse

required

string

document

required

La référence du document analysé.

string

outillage

required

L’identité de l’analyseur — un adaptateur, jamais une autorité.

string

version_outillage

required

string

analyse_le

required

string format: date

examinee

required

Vrai quand chaque geste (hors constats conformes) a son sort.

boolean

gestes

required

Array<object>

object

numero

required

integer

>= 1

geste

required

Le geste d’administration visé — jamais un geste inventé ; jamais une valeur liquidative.

string

Allowed values: referencer_instrument etablir_caracteristique reetablir_caracteristique poser_restriction lever_restriction annoncer_evenement

donnees

Les données extraites, aux noms filaires du geste visé.

object

rapprochement

required

Le conforme est un constat — il ne s’examine pas.

string

Allowed values: nouveau ecart conforme

confiance_pb

required

L’indice de confiance de l’extraction, en points de base.

integer

<= 10000

emplacement

required

Où, dans le document.

string

extrait

required

L’extrait cité — ce que le valideur lit en face du geste.

string

sort

object

sort

required

string

Allowed values: applique amende ecarte

motif

string

donnees

Les données réellement appliquées, si amendées — la comparaison proposé/appliqué se lit.

object

Example

{
  "gestes": [
    {
      "geste": "referencer_instrument",
      "rapprochement": "nouveau",
      "sort": {
        "sort": "applique"
      }
    }
  ]
}

400

La demande est irrecevable — le motif nomme le champ.

Media typeapplication/json

object

motif

required

Le motif, qui nomme le champ, l’identifiant ou l’invariant en cause.

string

Example^generated

{
  "motif": "example"
}

401

Aucune identité présentée.

403

L’identité présentée n’a pas la famille d’accès administration.

422

Le référentiel refuse (document inconnu de ce tenant, identifiant d’analyse déjà pris) — motivé.

Media typeapplication/json

object

motif

required

Le motif, qui nomme le champ, l’identifiant ou l’invariant en cause.

string

Example^generated

{
  "motif": "example"
}