Sécurisation des appels

Pour utiliser l’API Peopulse, chaque requête doit être sécurisée via un token JWT. Les explications ci-dessous décrivent comment générer un token à partir de vos identifiants Peopulse.

Générer un token

Pour générer un token, interrogez le endpoint POST /api/token :

Renseignez dans le body votre login, votre mot de passe, votre contexte (PORTAIL_EU si vous êtes un consommateur d’API côté Entreprise Utilisatrice, PORTAIL_ETT si vous êtes un consommateur d’API côté Entreprise de Travail Temporaire).

{
  "username": "your login on context",
  "password": "your password on context",
  "context": "Context (PORTAIL_EU or PORTAIL_ETT)"
}

Après avoir interrogé ce endpoint, vous obtenez en réponse un token :

{
  "token": "eyJ0eXAiOiJKV1QiLCJ...VUOghJndIlQ"
}

A chaque interrogation d’un endpoint de l’API Peopulse, vous devrez renseigner ce token dans le header. Par exemple :

curl -X 'GET' \
  'https://api.peopulse.com/api/v1/reasons' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJ...VUOghJndIlQ'

Réaliser des tests via la doc Swagger

Si vous souhaitez réaliser des tests via la doc Swagger, utilisez le endpoint POST /api/token présent en cliquant sur « Try it out ».

Renseignez vos identifiants, exécutez la requête, puis copiez le token obtenu dans la réponse. Utilisez le bouton « Authorize » et renseignez dans « bearerAuth » le token copié.

Vous pouvez ensuite tester les différents endpoints en utilisant le « Try it out » proposé sur chacun d’eux. Le token sera automatiquement renseigné dans les requêtes.