Stock.Depot¶
En bref
8 opérations sur 4 chemins. Préfixe /v2. Authentification JWT (voir Démarrer).
Opérations¶
| Méthode | Chemin | Rôle |
|---|---|---|
GET |
/v2/depot |
Lister les enregistrements |
POST |
/v2/depot |
Créer l'enregistrement |
PUT |
/v2/depot |
Mettre à jour l'enregistrement |
DELETE |
/v2/depot |
Supprimer l'enregistrement |
GET |
/v2/depot/count |
Compter les enregistrements |
POST |
/v2/depot/count |
Compter les enregistrements |
POST |
/v2/depot/recherche |
Rechercher des enregistrements |
POST |
/v2/depot/save |
Créer ou mettre à jour l'enregistrement (upsert) |
Rôle déduit
La spécification ne porte ni summary ni description d'opération : la colonne Rôle est déduite mécaniquement de la méthode HTTP et du chemin.
Détail¶
GET /v2/depot¶
Lister les enregistrements.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
sort |
query | string |
non | — |
where |
query | string |
non | — |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/v2/depot?sort=<sort>&where=<where>" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
POST /v2/depot¶
Créer l'enregistrement.
Corps de la requête (application/json)
Schéma DepotDto — 22 propriétés (détail : Schémas).
Écriture partielle : seules les propriétés présentes dans le corps sont écrites (voir Conventions).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/v2/depot" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"id": 0, "intitule": "…", "adresse": "…"}'
PUT /v2/depot¶
Mettre à jour l'enregistrement.
Corps de la requête (application/json)
Schéma DepotDto — 22 propriétés (détail : Schémas).
Écriture partielle : seules les propriétés présentes dans le corps sont écrites (voir Conventions).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X PUT "https://<votre-connecteur>/v2/depot" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"id": 0, "intitule": "…", "adresse": "…"}'
DELETE /v2/depot¶
Supprimer l'enregistrement.
Corps de la requête (application/json)
Schéma DepotDto — 22 propriétés (détail : Schémas).
Écriture partielle : seules les propriétés présentes dans le corps sont écrites (voir Conventions).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X DELETE "https://<votre-connecteur>/v2/depot" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"id": 0, "intitule": "…", "adresse": "…"}'
GET /v2/depot/count¶
Compter les enregistrements.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
where |
query | string |
non | — |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/v2/depot/count?where=<where>" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
POST /v2/depot/count¶
Compter les enregistrements.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/v2/depot/count" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
POST /v2/depot/recherche¶
Rechercher des enregistrements.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/v2/depot/recherche" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
POST /v2/depot/save¶
Créer ou mettre à jour l'enregistrement (upsert).
Corps de la requête (application/json)
Schéma DepotDto — 22 propriétés (détail : Schémas).
Écriture partielle : seules les propriétés présentes dans le corps sont écrites (voir Conventions).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/v2/depot/save" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"id": 0, "intitule": "…", "adresse": "…"}'
Schémas¶
Schémas résolus à un niveau : les propriétés qui référencent un autre schéma sont citées par leur nom, sans être dépliées.
DepotDto¶
DepotDto — 22 propriétés
| Propriété | Type | Notes |
|---|---|---|
id |
integer (int32) |
— |
intitule |
string |
nullable |
adresse |
string |
nullable |
complement |
string |
nullable |
codePostal |
string |
nullable |
ville |
string |
nullable |
region |
string |
nullable |
pays |
string |
nullable |
telephone |
string |
nullable |
telecopie |
string |
nullable |
email |
string |
nullable |
contact |
string |
nullable |
estPrincipal |
boolean |
— |
code |
string |
nullable |
idCategorieComptable |
integer (int32) |
— |
exclure |
boolean |
— |
idSoucheVente |
integer (int32) |
— |
idSoucheAchat |
integer (int32) |
— |
idSoucheInterne |
integer (int32) |
— |
idEmplacementDefaut |
integer (int32) |
— |
dateCreation |
string (date-time) |
— |
dateModification |
string (date-time) |
— |