🇸🇳
Géo-Sénégalv1.0.0
🌍 Infrastructure géographique de référence

Géo-Sénégal API

L'infrastructure de données géographiques la plus complète du Sénégal. Accédez instantanément aux 14 régions, 45 départements, 552 communes et des milliers de quartiers, villages et hameaux. Optimisée pour le secteur agro-industriel et la logistique.

⚡ Tester l'API🔑 Obtenir une clé
🗺️
14
Régions
📍
45
Départements
🏘️
552
Communes
⚡
99.9%
Disponibilité
Sécurité

Authentification

Toutes les requêtes (sauf /api/health et /docs) nécessitent une clé API valide.

🔑 Format de la clé API

sngl_live_<64 caractères hex>
Header X-API-KeyRecommandé
X-API-Key: sngl_live_abc123...
Bearer Token
Authorization: Bearer sngl_live_abc123...

⚡ Limites de débit (Rate Limiting)

Lecture (GET)1 000 req/min
Écriture (POST/PUT/DELETE)100 req/min
Sans clé API100 req/min
Les en-têtes X-RateLimit-Remaining et Retry-After sont inclus dans chaque réponse.
Endpoints

Référence des endpoints

L'API est organisée selon la hiérarchie administrative officielle du Sénégal.

GET
Géographie
/api/regions

Liste des 14 régions administratives du Sénégal. Supporte la pagination curseur et le filtrage par nom.

?nom?limite?curseur
GET
Géographie
/api/departements

Liste des départements. Filtrage par région_id pour obtenir les départements d'une région spécifique.

?nom?region_id?limite
GET
Géographie
/api/com-arrt-villes

Communes, arrondissements et villes. Filtrage par departement_id.

?nom?departement_id?limite
GET
Géographie
/api/communes

Collectivités locales (communes). Filtrage par com_arrt_ville_id.

?nom?com_arrt_ville_id?limite
GET
Géographie
/api/quartiers

Quartiers, villages et hameaux. Filtrage par commune_id.

?nom?commune_id?limite
GET
Géographie
/api/localites

Vue aplatie traversant toute la hiérarchie. Filtrage multi-niveaux simultané. Cache Redis 5 min.

?region?departement?commune?limite
GET
Recherche
/api/localites/search

Recherche full-text PostgreSQL sur l'ensemble des localités. Supporte la recherche approximative.

?q?niveau?limite
GET
Système
/api/health

Statut de l'API, de la base de données et du cache Redis. Endpoint public, sans authentification.

Exemples

Exemples de code

Intégrez l'API en quelques lignes dans votre stack technologique.

🗺️ Lister les régionsGET /api/regions

curl https://api.senegal-localites.sn/api/regions \
  -H "X-API-Key: sngl_live_votre_cle"

📍 Départements d'une régionGET /api/departements

curl "https://api.senegal-localites.sn/api/departements?region_id=<UUID>" \
  -H "X-API-Key: sngl_live_votre_cle"

🔍 Recherche Full-TextGET /api/localites/search

curl "https://api.senegal-localites.sn/api/localites/search?q=Plateau&niveau=commune" \
  -H "X-API-Key: sngl_live_votre_cle"
Erreurs

Guide des codes d'erreur

L'API retourne des erreurs structurées conformes au standard RFC 7807.

400PARAMETRES_INVALIDES

Cause

Paramètres manquants ou format incorrect

Solution

Vérifiez les types et valeurs des paramètres

401NON_AUTHENTIFIE

Cause

Clé API absente ou invalide

Solution

Ajoutez l'en-tête X-API-Key avec une clé valide

404RESSOURCE_INTROUVABLE

Cause

L'identifiant fourni n'existe pas

Solution

Vérifiez l'UUID ou les filtres utilisés

409CONFLIT

Cause

La ressource existe déjà en base

Solution

Utilisez PUT pour mettre à jour une ressource existante

429TROP_DE_REQUETES

Cause

Limite de débit dépassée

Solution

Attendez la durée indiquée dans Retry-After

500ERREUR_INTERNE

Cause

Erreur inattendue côté serveur

Solution

Contactez support : api@senegal-localites.sn

Format de réponse d'erreur

{
  "statut": 401,
  "code": "NON_AUTHENTIFIE",
  "message": "Authentification requise. Fournissez une clé API valide.",
  "timestamp": "2026-03-18T12:00:00.000Z",
  "chemin": "/api/regions"
}
Interactif

Explorateur d'API

Testez tous les endpoints directement depuis cette page. Cliquez sur 'Authorize' pour saisir votre clé API.