🇸🇳
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
/api/regions

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

?nom?limite?curseur
Géographie
GET
/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
Géographie
GET
/api/com-arrt-villes

Communes, arrondissements et villes. Filtrage par departement_id.

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

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

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

Quartiers, villages et hameaux. Filtrage par commune_id.

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

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

?region?departement?commune?limite
Géographie
GET
/api/localites/search

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

?q?niveau?limite
Recherche
GET
/api/health

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

Système
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.

Code HTTPCode interneCauseSolution
400PARAMETRES_INVALIDESParamètres manquants ou format incorrectVérifiez les types et valeurs des paramètres
401NON_AUTHENTIFIEClé API absente ou invalideAjoutez l'en-tête X-API-Key avec une clé valide
404RESSOURCE_INTROUVABLEL'identifiant fourni n'existe pasVérifiez l'UUID ou les filtres utilisés
409CONFLITLa ressource existe déjà en baseUtilisez PUT pour mettre à jour une ressource existante
429TROP_DE_REQUETESLimite de débit dépasséeAttendez la durée indiquée dans Retry-After
500ERREUR_INTERNEErreur inattendue côté serveurContactez 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.