Aller au contenu

Entités

Création d'une entité

Route

POST /rest/entities

Paramètres

Body

Valeur Type Obligatoire Valeur par défaut Description
entity_id string Oui Identifiant métier
entity_label string Oui Description
short_label string Oui Description courte
entity_type string Oui Type d'entité
addressNumber string Non Numéro de la rue
addressStreet string Non Nom de la rue
addressAdditional1 string Non Point de remise
addressAdditional2 string Non Complément d'acheminement
addressPostcode string Non Code postal
addressTown string Non Ville
addressCountry string Non Pays
email string Non Courriel
business_id string Non Siret de l'entité
parent_entity_id string Non Identifiant parent de l'entité
producerService string Non Identifiant de l'entité dans le SAE
Exemple
{
    "entity_id" : "PJ",
    "entity_label" : "Police judiciaire",
    "short_label" : "PJ",
    "entity_type" : "Service",
    "parent_entity_id" : "PO"
}

Retour

Code Http Type Description Exemple
200 array Donnée enregistrée ['entities' => [] ]
400 array Un paramètre obligatoire est manquant ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Modification d'une entité

Route

PUT /rest/entities/{id}

Le paramètre id de la route représente l'identifiant métier (entities.entity_id) de l'entité à modifier.

Paramètres

Body

Valeur Type Obligatoire Valeur par défaut Description
entity_label string Oui Description
short_label string Oui Description courte
entity_type string Oui Type d'entité
addressNumber string Non Numéro de la rue
addressStreet string Non Nom de la rue
addressAdditional1 string Non Point de remise
addressAdditional2 string Non Complément d'acheminement
addressPostcode string Non Code postal
addressTown string Non Ville
addressCountry string Non Pays
email string Non Courriel
business_id string Non Siret de l'entité
parent_entity_id string Non Identifiant parent de l'entité
producerService string Non Identifiant de l'entité dans le SAE
Exemple
{
    "entity_label" : "Police judiciaire",
    "short_label" : "PJ",
    "entity_type" : "Service"
}

Retour

Code Http Type Description Exemple
200 array Donnée enregistrée
400 array Un paramètre obligatoire est manquant ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Suppression d'une entité

Route

DELETE /rest/entities/{id}

Le paramètre id de la route représente l'identifiant métier (entities.entity_id) de l'entité à supprimer.

Retour

Code Http Type Description Exemple
200 array La modification a bien été prise en compte
400 array ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Liste des entités

Route

GET /rest/entities

Retour

Code Http Type Description Exemple
200 array liste des entités ["entities" => [] ]
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Exemple

{
    "entities":[
        {
            "id":"dddd",
            "entity_id":"dddd",
            "entity_label":"dddd",
            "parent_entity_id":"",
            "parent_id":null,
            "serialId":242,
            "parentSerialId":"#",
            "parent":"#",
            "icon":"fa fa-building",
            "allowed":true,
            "state":{"opened":true},
            "text":"dddd"
        },
        {...}
    ]
}

Création d'une liste de diffusion, d'un circuit de visa ou d'avis pour l'entité

Route

POST /rest/listTemplates?admin=true

Paramètres

Body

Valeur Type Obligatoire Valeur par défaut Description
entityId int Oui Identifiant technique de l'entité
type string Oui Type de la liste
title string Oui Titre
description string Oui Description
items string Oui Eléments de la liste
Exemple
{
    "entityId" : 15,
    "type" : "diffusionList",
    "title" : "Liste PJ",
    "description" : "Liste de diffusion PJ",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "dest"
        },
        {
            "id" : 16,
            "type" : "user",
            "mode" : "cc"
        },
        {
            "id" : 8,
            "type" : "entity",
            "mode" : "cc"
        }
    ]
}

{
    "entityId" : 15,
    "type" : "visaCircuit",
    "title" : "Circuit de visa PJ",
    "description" : "Circuit de visa PJ",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "visa"
        },
        {
            "id" : 16,
            "type" : "user",
            "mode" : "visa"
        },
        {
            "id" : 22,
            "type" : "user",
            "mode" : "sign"
        }
    ]
}

{
    "entityId" : 15,
    "type" : "opinionCircuit",
    "title" : "Circuit d'avis PJ",
    "description" : "Circuit d'avis PJ",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "avis"
        },
        {
            "id" : 16,
            "type" : "user",
            "mode" : "avis"
        },
        {
            "id" : 22,
            "type" : "user",
            "mode" : "avis"
        }
    ]
}

Retour

Code Http Type Description Exemple
200 array Donnée enregistrée ['id' => 2 ]
400 array Un paramètre obligatoire est manquant ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Modification d'une liste de diffusion, d'un circuit de visa ou d'avis pour l'entité

Route

PUT /rest/listTemplates/{id}

Le paramètre id correspond à l'identifiant du modèle de liste de diffusion list_templates.id.

Paramètres

Body

Valeur Type Obligatoire Valeur par défaut Description
title string Oui Titre
description string Non Description
items string Oui Eléments de la liste
Exemple
{
    "title" : "Liste PJ modifié",
    "description" : "Liste de diffusion PJ modifié",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "dest"
        },
        {
            "id" : 8,
            "type" : "entity",
            "mode" : "cc"
        }
    ]
}

{
    "title" : "Circuit de visa PJ v2",
    "description" : "Circuit de visa PJ v2",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "visa"
        },
        {
            "id" : 22,
            "type" : "user",
            "mode" : "sign"
        }
    ]
}

{
    "title" : "Circuit d'avis PJ v2",
    "description" : "Circuit d'avis PJ v2",
    "items" : [
        {
            "id" : 3,
            "type" : "user",
            "mode" : "avis"
        },
        {
            "id" : 22,
            "type" : "user",
            "mode" : "avis"
        }
    ]
}

Retour

Code Http Type Description Exemple
204 array Donnée enregistrée
400 array Un paramètre obligatoire est manquant ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']

Suppression d'une liste de diffusion, d'un circuit de visa ou d'avis pour l'entité

Route

DELETE /rest/listTemplates/{id}

Le paramètre id correspond à l'identifiant du modèle de liste de diffusion list_templates.id.

Retour

Code Http Type Description Exemple
204 array Donnée enregistrée
400 array ['errors' => 'Bad Request']
403 array Droits insuffisants pour cette action ['errors' => 'Service forbidden']
500 array Une erreur s'est produite ['errors' => '...']