Verser un document de référence — immuable, empreint, archivé.

POST

/tenants/{tenant}/documents

curl --request POST \
  --url https://example.com/tenants/example/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "document": "example", "type": "prospectus", "no_version": 1, "date_edition": "2026-04-15", "date_application": "2026-04-15", "emetteur": "example", "instruments": [ "example" ], "contenu_texte": "example" }'

Le temps 1 de l’alimentation documentaire : l’identité (le type, l’émetteur — un intervenant référencé —, la version, les dates), le rattachement aux instruments concernés, et le contenu — archivé derrière l’adaptateur de stockage, le référentiel n’en gardant que l’empreinte (calculée au versement). Un contenu déjà versé chez ce tenant (même empreinte) est reconnu, pas dupliqué : la réponse renvoie le document existant. Une nouvelle édition est un nouveau document — l’ancien reste, à jamais.

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.

Corps de la requête^required

Media typeapplication/json

object

document

required

La référence du document — unique chez ce tenant, une édition = un document.

string

>= 1 characters

type

required

string

Allowed values: prospectus document_d_informations_cles reglement_du_fonds lettre_aux_porteurs

no_version

required

integer

>= 1

date_edition

required

string format: date

date_application

required

string format: date

emetteur

required

L’identifiant publié de l’intervenant émetteur — référencé chez ce tenant.

string

>= 1 characters

instruments

Les instruments rattachés — déclarés au versement, complétables à l’examen.

Array<string>

contenu_texte

required

Le contenu textuel du document — archivé derrière l’adaptateur de stockage, jamais dans le référentiel ; l’empreinte est calculée au versement.

string

>= 1 characters

Réponses

200

Le contenu était déjà versé — le document existant est reconnu, rien n’est dupliqué.

Media typeapplication/json

object

tenant

required

string

document

required

La référence servie — celle du versement, ou celle du document reconnu par l’empreinte.

string

empreinte

required

L’empreinte du contenu (SHA-256, hexadécimal).

string

Example^generated

{
  "tenant": "example",
  "document": "example",
  "empreinte": "example"
}

201

Le document est versé — son empreinte fait foi.

Media typeapplication/json

object

tenant

required

string

document

required

La référence servie — celle du versement, ou celle du document reconnu par l’empreinte.

string

empreinte

required

L’empreinte du contenu (SHA-256, hexadécimal).

string

Example^generated

{
  "tenant": "example",
  "document": "example",
  "empreinte": "example"
}

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 (référence déjà prise, émetteur ou instrument rattaché inconnu de ce tenant — la muraille ne révèle rien) — 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"
}