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)