Etape 2 - Requêter une API

L'URL permettant de requêter une API est constituée des éléments suivants :

  1. le point d'accès https://api.emploi-store.fr/partenaire
  2. l'identifiant de l'API (code et version de l'API)
  3. le nom de la ressource
  4. les paramètres spécifiques à l'API manipulée


Ainsi, une requête se présente sous la forme suivante :

https://api.emploi-store.fr/partenaire/[Code de l'API]/[Version de l'API]/[Nom de la ressource][Paramètres spécifiques à l'API]

 

L'en-tête HTTP suivant doit être valorisé systématiquement :

En-tête(s) Valeur
Authorization Bearer Valeur de l'access token

 

Exemple d'appel :

GET /partenaire/labonneboite/v1/company/?distance=30&latitude=49.119146&longitude=6.17602&rome_codes=M1607

Authorization: Bearer [Access token]

 

Exemple de retour :

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

{ "companies": [ { "distance": 2, "headcount_text": "6 à 9 salariés", "lat": 48.97609, "city": "PAGNY-SUR-MOSELLE", "naf": "4711D", "name": "LIDL", "naf_text": "Supermarchés", "lon": 5.99792, "siret": "34326262214546" }, { "distance": 3, "headcount_text": "10 à 19 salariés", "lat": 48.97609, "city": "PAGNY-SUR-MOSELLE", "naf": "4711D", "name": "CARREFOUR CONTACT", "naf_text": "Supermarchés", "lon": 5.99792, "siret": "50761894000021" } ] }

 

Cas d'erreurs possibles

Access token erroné ou absent :

HTTP 401 Unauthorized
Content-Type: application/json
Cache-Control: no-store
Pragma: no-cache