Etape 2 - Requêter une API
L'URL permettant de requêter une API est constituée des éléments suivants :
- le point d'accès
https://api.emploi-store.fr/partenaire
- l'identifiant de l'API (code et version de l'API)
- le nom de la ressource
- 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