Premiers pas

Aperçu

Oolel Maps fournit une API RESTful pour le géocodage, la recherche, la navigation et la gestion d'adresses en Afrique de l'Ouest. Tous les points d'accès retournent du JSON et prennent en charge le français, l'arabe et l'anglais via le paramètre .

https://api.oolel.com

Rendez-vous sur la page d'inscription et créez un compte développeur gratuit. Vous devrez fournir votre nom, adresse email et éventuellement le nom de votre entreprise.

Après vous être connecté, naviguez vers la section Clés API de votre tableau de bord. Cliquez sur "Créer une nouvelle clé" et donnez-lui un nom descriptif (par exemple "Production" ou "Développement"). Copiez et conservez votre clé en sécurité — vous ne pourrez plus la voir après sa création.

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

curl -X GET "https://api.oolel.com/geocoding/forward?q=Tevragh+Zeina+Nouakchott" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentification

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

Authorization: Bearer YOUR_API_KEY

Les requêtes sans clé API valide recevront une réponse 401 Unauthorized.

Limites de débit

Le forfait gratuit inclut 10 000 requêtes par mois. Les limites de débit sont appliquées par clé API avec un maximum de 100 requêtes par minute. Les en-têtes suivants sont inclus dans chaque réponse :

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

Gestion des erreurs

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

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