Auth.Auth
En bref
7 opérations sur 7 chemins. Préfixe /v2. Authentification JWT (voir Démarrer).
Opérations
| Méthode | Chemin | Rôle |
|---|---|---|
POST |
/v2/auth/change-password |
Appel POST sur auth/change-password |
POST |
/v2/auth/login |
Appel POST sur auth/login |
POST |
/v2/auth/login-token |
Appel POST sur auth/login-token |
GET |
/v2/auth/ping |
Appel GET sur auth/ping |
POST |
/v2/auth/refresh-token |
Appel POST sur auth/refresh-token |
POST |
/v2/auth/register |
Appel POST sur auth/register |
GET |
/v2/auth/test |
Appel GET sur auth/test |
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
POST /v2/auth/change-password
Appel POST sur auth/change-password.
Corps de la requête (application/json)
Schéma UserDto - 2 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>/v2/auth/change-password" \
-H "Authorization: Bearer <jeton>" \
-H "Content-Type: application/json" \
-d '{"username": "…", "password": "…"}'
POST /v2/auth/login
Appel POST sur auth/login.
Corps de la requête (application/json)
Schéma UserDto - 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>/v2/auth/login" \
-H "Content-Type: application/json" \
-d '{"username": "…", "password": "…"}'
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
POST /v2/auth/login-token
Appel POST sur auth/login-token.
Corps de la requête (application/json)
Schéma VerifyTokenDto - 4 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>/v2/auth/login-token" \
-H "Content-Type: application/json" \
-d '{"email": "…", "token": "…", "hid": "…"}'
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
GET /v2/auth/ping
Appel GET sur auth/ping.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | - |
Exemple
curl -s -X GET "https://<votre-connecteur>/v2/auth/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é).
POST /v2/auth/refresh-token
Appel POST sur auth/refresh-token.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | - |
Exemple
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
POST /v2/auth/register
Appel POST sur auth/register.
Corps de la requête (application/json)
Schéma UserDto - 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>/v2/auth/register" \
-H "Content-Type: application/json" \
-d '{"username": "…", "password": "…"}'
Cette opération est déclarée anonyme dans le contrat (aucun schéma de sécurité).
GET /v2/auth/test
Appel GET sur auth/test.
Réponses
| Code | Description | Schéma de data |
|---|---|---|
200 |
OK | - |
401 |
Unauthorized | - |
403 |
Forbidden | - |
Exemple
curl -s -X GET "https://<votre-connecteur>/v2/auth/test?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.
UserDto
UserDto - 2 propriétés
| Propriété | Type | Notes |
|---|---|---|
username |
string |
nullable |
password |
string |
nullable |
VerifyTokenDto
VerifyTokenDto - 4 propriétés
| Propriété | Type | Notes |
|---|---|---|
email |
string |
nullable |
token |
string |
nullable |
hid |
string |
nullable |
service |
string |
nullable |