API Se connecter avec Pôle emploi (entreprise) v1

Présentation

L’API Se connecter avec Pôle emploi (entreprise) permet à un utilisateur recruteur de se connecter à votre application avec son compte Pôle emploi. La solution repose sur la cinématique d'authentification utilisateur proposée par Pôle Emploi Access Management.

L'API remonte en retour quelques informations liées à l'utilisateur connecté.

 

Caractéristiques

Mode d'accès restreint (demande d'accès soumise à validation de Pôle emploi)
Fréquence de mise à jour Temps réél
Cinématique OAuth authorization code flow
Royaume Pôle Emploi Access Management /employeur
Scopes

Obligatoires :

Facultatifs :

  • profile
  • email
  • habilitation

 

Description de la requête

URL du point d'accès

https://api.emploi-store.fr/partenaire/peconnect-entreprise/v1/userinfo

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/peconnect-entreprise/v1/userinfo

Authorization: [Access token]

 

Description de la réponse

Données retournées

Code Cardinalité Format Description
sub 1,1 String

Identifiant unique du recruteur

updated_at 1,1 timestamp Date de mise à jour des identifiants
update_at 1,1

date yyyymmddhhmiss

Date de mise à jour des identifiants
nickname 1,1 String Nom d'utilisateur de la personne morale
email 1,1 String Adresse mail de la personne morale
email_verified 1,1 Boolean  
gender 1,1 String

Sexe de la personne morale
Valeurs possibles :

  • male (homme)
  • female (femme)
given_name 1,1 String

Nom de la personne morale

family_name 1,1 String

Prénom de la personne morale

habilitation

1,1 String

Indique si le compte du recruteur est certifié par Pôle emploi

Valeurs possibles :

  • recruteur (non certifié)
  • recruteucertifie (certifié)

 

Exemple de retour

HTTP 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "sub": "cc88654d-54fc-4ce0-b5e5-2d01a7011ea1",
    "updated_at": "1529478678",
    "update_at": "20180620111118",
    "nickname": "henrydurant",
    "email": "mail@pole-emploi.fr",
    "email_verified": "false",
    "gender": "male",
    "family_name": "Durant",
    "given_name": "Henri",
    "habilitation": "recruteurcertifie"
}

 

Cas d'erreurs possibles

Retrouvez la liste des cas d'erreurs possibles sur la page Erreurs Types.