La file des demandes de validation

GET

/demandes-de-validation

curl --request GET \
  --url 'https://example.com/demandes-de-validation?objet=referencement&etat=en_attente&page=1&taille=50' \
  --header 'Authorization: Bearer <token>'

Autorisations

• authentification
  instruments:administration

Paramètres

Paramètres (query)

objet

string

Allowed values: referencement transition_de_cycle caracteristique restriction regle_de_valorisation relation role_d_intervenant version_de_calendrier exception_de_calendrier intervenant

cible

string

>= 1 characters

L’identifiant de l’entité visée (instrument, véhicule, calendrier…).

prepare_par

string

>= 1 characters

en_attente_depuis

string format: date

Ne servir que les demandes soumises avant cette date.

etat

string

default: en_attente

Allowed values: en_attente validee refusee

page

integer

default: 1 >= 1

taille

integer

default: 50 >= 1 <= 500

Réponses

200

La page demandée.

Media typeapplication/json

object

lignes

required

Array<object>

object

demande

required

string

objet

required

string

Allowed values: referencement transition_de_cycle caracteristique restriction regle_de_valorisation relation role_d_intervenant version_de_calendrier exception_de_calendrier intervenant

cible

required

object

type

required

string

Allowed values: instrument vehicule calendrier intervenant

reference

required

string

libelle

string

ce_qui_change

required

Le résumé lisible de l’établissement demandé.

string

source

La provenance de l’établissement (document

string

prepare_par

required

string

soumise_le

required

string format: date-time

anciennete_jours

required

L’ancienneté SERVIE — le consommateur ne la calcule jamais.

integer

effet

L’effet prévu — ou déjà en vigueur pour une urgence (validation a posteriori).

object

prevu_le

string format: date

deja_en_vigueur

boolean

echeance_de_revue

string format: date

etat

required

string

Allowed values: en_attente validee refusee

refus_de_validation

Pourquoi le LECTEUR ne peut pas valider cette demande (« préparée par vous — un autre valideur est requis ») — absent quand elle lui est recevable. Le verdict est servi, jamais déduit.

string

gestes

required

Les gestes ouverts au lecteur — servis, jamais déduits de l’état.

Array<string>

Allowed values: valider refuser lever

total

required

integer | null

Example

{
  "lignes": [
    {
      "objet": "referencement",
      "cible": {
        "type": "instrument"
      },
      "etat": "en_attente",
      "gestes": [
        "valider"
      ]
    }
  ]
}

400

La demande est irrecevable (champ manquant, date mal formée, flottant…) — le motif nomme le champ.

Media typeapplication/json

object

motif

required

Le motif

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 instruments:administration.