Obtenir le nombre d'entreprises

Présentation

Cette ressource permet de récupérer le nombre d'entreprises susceptibles de recruter dans les 6 prochains mois.

 

Description de la requête

Point d'accès

GET https://api.emploi-store.fr/partenaire/labonneboite/v1/company/count/

 

Paramètres d'entrée

Les données retournées sont identiques à la Recherche d'entreprises.

 

Exemple d'appel

GET https://api.emploi-store.fr/partenaire/labonneboite/v1/company/count/?distance=30&latitude=49.119146&longitude=6.17602&rome_codes=M1607

Authorization: Bearer [Access token]

 

Description de la réponse

Lors de la réponse de l'API, une redirection (code HTTP 302 Found) est réalisée du domaine https://api.emploi-store.fr/api/lbb/v1/company vers le domaine https://labonneboite.pole-emploi.fr/api/v1/company/.

Vous devez explicitement indiquer à votre client HTTP de suivre les redirections car il ne le fait probablement pas par défaut. Par exemple pour le client curl, il est nécéssaire d'utiliser curl --location (ou curl -L).

 

Données retournées

Code Cardinalité Format Description
companies_count 1,1 String Nombre total d'entreprises correspondant à la recherche
rome_code 1,1 String Code ROME utilisé pour la recherche
rome_label 1,1 String Libellé du code ROME utilisé pour la recherche
url 1,1 String URL frontend de la recherche si possible, ou sinon URL de la page d'accueil

 

Exemple de retour

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

{
  "companies_count": 649,
  "rome_code": "M1607",
  "rome_label": "Secrétariat",
  "url": "https://labonneboite.pole-emploi.fr/"
}

 

Cas d'erreurs possibles

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

API en cours de maintenance :

HTTP 502 Bad gateway
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache

L'API est susceptible de connaitre occasionnellement de brèves indisponibilités (micro-coupures pendant certains déploiements).
Par conséquent, votre application doit contrôler le code retour de l'API. Le code HTTP 502 signifie que l'API est temporairement indisponible. Vous pourrez retenter l'appel quelques secondes plus tard.

 

Syntaxe de la requête erronnée :

HTTP 400 Bad request
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache

{
  "codeErreur": "1493122545783",
  "codeHttp": 400,
  "message": "Aucun code_rome trouvé"
}

La réponse 400 s'accompagne d'un message explicite qui vous indique le problème rencontré par votre requête :

  • code_commune inconnu
  • Aucun code_rome trouvé (uniquement si vous utilisez rome_code_keyword_search)