Server¶
En bref
7 opérations sur 6 chemins. Routes héritées, sans préfixe /v2. Authentification JWT (voir Démarrer).
Routes héritées
Les chemins de ce groupe ne portent pas le préfixe /v2 : ils proviennent de la surface historique du connecteur, publiée dans la même spécification. Pour une intégration neuve, préférez l'équivalent /v2 (voir Conventions).
Opérations¶
| Méthode | Chemin | Rôle |
|---|---|---|
GET |
/Server/check |
Appel GET sur Server/check |
GET |
/Server/config/{configName} |
Appel GET sur Server/config |
POST |
/Server/config/{configName} |
Appel POST sur Server/config |
GET |
/Server/ping |
Appel GET sur Server/ping |
GET |
/Server/sync-confirm |
Appel GET sur Server/sync-confirm |
POST |
/Server/token |
Appel POST sur Server/token |
GET |
/Server/version |
Appel GET sur Server/version |
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 /Server/check¶
Appel GET sur Server/check.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
UserEmail |
query | string |
non | — |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/Server/check?UserEmail=<UserEmail>" \
-H "Accept: application/json"
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
GET /Server/config/{configName}¶
Appel GET sur Server/config.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
configName |
path | string |
oui | — |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/Server/config/<configName>" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
POST /Server/config/{configName}¶
Appel POST sur Server/config.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
configName |
path | string |
oui | — |
Corps de la requête (application/json)
Schéma ConfigDto — 1 propriétés (détail : Schémas).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/Server/config/<configName>" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"valeur": "…"}'
GET /Server/ping¶
Appel GET sur Server/ping.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/Server/ping?targets=DEMO&limit=50" \
-H "Accept: application/json"
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
GET /Server/sync-confirm¶
Appel GET sur Server/sync-confirm.
Paramètres
| Nom | Emplacement | Type | Obligatoire | Description |
|---|---|---|---|---|
id |
query | string |
non | — |
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/Server/sync-confirm?id=<id>" \
-H "Accept: application/json"
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
POST /Server/token¶
Appel POST sur Server/token.
Corps de la requête (application/json)
Schéma LivraisonJetonDto — 2 propriétés (détail : Schémas).
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
Exemple
curl -s -X POST "https://<votre-connecteur>/Server/token" \
-H "Content-Type: application/json" \
-d '{"delivery_id": "…", "server_token": "…"}'
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
GET /Server/version¶
Appel GET sur Server/version.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | — |
401 |
Unauthorized | — |
403 |
Forbidden | — |
Exemple
curl -s -X GET "https://<votre-connecteur>/Server/version?targets=DEMO&limit=50" \
-H "Authorization: Bearer <jeton>" \
-H "Accept: application/json"
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.
ConfigDto¶
ConfigDto — 1 propriétés
| Propriété | Type | Notes |
|---|---|---|
valeur |
string |
nullable |
LivraisonJetonDto¶
LivraisonJetonDto — 2 propriétés
| Propriété | Type | Notes |
|---|---|---|
delivery_id |
string |
nullable |
server_token |
string |
nullable |