Authentification

Chaque point de terminaison de l’API Genesis attend un jeton dans l’en-tête auth-token de la requête. Une requête sans celui‑ci renvoie 401.

Obtenir un jeton

Échanger un identifiant d’API contre un jeton avec POST /proxy/apiToken. L’identifiant est délivré par fournisseur de services, ainsi la requête indique le fournisseur pour lequel le jeton doit agir.

{
  "serviceProviderId": "string (required)",
  "accessId": "string (required)",
  "clientSecret": "string (required)"
}

L’identifiant accessId et clientSecret sont délivrés dans la plateforme Genesis sous les paramètres du fournisseur de services. Conservez le secret sur votre serveur : un jeton peut être envoyé à un navigateur, l’identifiant qui le génère ne doit pas l’être.

Utiliser le jeton

curl -H "auth-token: <token>" https://api.nxgen.cloud/api/v1/user/me

GET /user/me renvoie le compte auquel le jeton appartient, ce qui constitue le test le plus rapide de la validité d’un jeton.

Essayer les requêtes depuis la documentation

La référence interactive à /api-reference est la même spécification dans Swagger UI, et l’Aperçu répertorie chaque ressource. Appuyer sur Authorize, coller un jeton, et chaque Essayer panneau l’envoie comme auth-token. Le jeton reste dans votre navigateur ; les requêtes sont envoyées directement depuis celui‑ci vers https://api.nxgen.cloud/api/v1.