Établir une caractéristique datée — typée, datée, avec sa provenance.

POST

/tenants/{tenant}/instruments/{instrument}/caracteristiques

curl --request POST \
  --url https://example.com/tenants/example/instruments/example/caracteristiques \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "type": "periodicite_de_publication", "du": "2026-04-15", "au": "2026-04-15", "provenance": { "source": "document", "document": "example" }, "periodicite": "quotidienne", "heure_limite": "example", "classification": "example", "droits_entree_pb": 1, "droits_sortie_pb": 1, "part_minimale_pb": 1, "part_maximale_pb": 1, "taux_pb": 1, "convention": "example" }'

Le type commande les champs du corps ; une caractéristique inapplicable à la nature est un rejet, pas une donnée ignorée. Les périodes sont [du, au[ sans chevauchement ; la provenance est obligatoire (la référence documentaire exigée quand la source est un document). Aucun fait n’est publié.

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.

instrument

required

string

>= 1 characters

L’identifiant publié de l’instrument chez ce tenant.

Corps de la requête^required

Media typeapplication/json

object

type

required

Le type commande les champs — la typologie est fermée.

string

Allowed values: periodicite_de_publication heure_limite_de_collecte classification frais_du_fonds contrainte_solidaire taux_d_interet

du

required

string format: date

au

La borne de fin, exclue — absente si la période est ouverte.

string format: date

provenance

required

object

source

required

string

Allowed values: document saisie flux_de_place

document

La référence du document — obligatoire quand la source est un document.

string

periodicite

string

Allowed values: quotidienne hebdomadaire mensuelle

heure_limite

Le cut-off (HH:MM).

string

classification

string

droits_entree_pb

integer

droits_sortie_pb

integer

part_minimale_pb

integer

part_maximale_pb

integer

taux_pb

integer

convention

string

Réponses

201

La caractéristique est établie.

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 (instrument inconnu de ce tenant — la muraille ne révèle rien —, type inapplicable à la nature, chevauchement de périodes) — 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"
}