Démarrage

Vue d'ensemble

Oolel Maps fournit une API REST pour le géocodage, la recherche et la navigation en Afrique de l'Ouest. Tous les endpoints se trouvent sous le préfixe /api/v1, renvoient du JSON et supportent le français, l'arabe et l'anglais via un paramètre de langue.

https://api.oolelmaps.com/api/v1

Rendez-vous sur la page d'inscription et créez un compte développeur gratuit. Vous devrez fournir votre adresse e-mail, un mot de passe et éventuellement le nom de votre société.

Après connexion, allez dans la section Clés API de votre tableau de bord. Cliquez sur « Créer une nouvelle clé » et donnez-lui un nom descriptif (par ex. « Production » ou « Développement »). Copiez et stockez votre clé en lieu sûr — elle ne sera plus affichée après sa création.

Utilisez votre clé API dans l'en-tête Authorization avec le préfixe Bearer. Voici un exemple simple de géocodage avant :

curl -X GET "https://api.oolelmaps.com/api/v1/geocode/forward?address=Tevragh+Zeina+Nouakchott" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentification

Toutes les requêtes API doivent inclure votre clé dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Les requêtes sans clé API valide reçoivent une réponse 401 Unauthorized.

Limites de débit

Chaque clé API est soumise à un throttling global pour éviter les abus. Si vous dépassez la limite, l'API répond avec 429 Too Many Requests. Contactez le support si votre charge de production nécessite un débit plus élevé.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709683200

Gestion des erreurs

L'API utilise les codes HTTP standards. Les réponses d'erreur incluent un corps JSON avec un message descriptif :

{
  "statusCode": 400,
  "message": "Query parameter 'address' is required",
  "error": "Bad Request"
}