API e-Structure
Documentation
Accédez aux données des structures essentielles du Tchad — santé, éducation, hydraulique et énergie — via une API REST simple, rapide et ouverte.
# Exemple — structures de santé curl -X GET \ "https://estructuretchad.com/api/v1/structures?secteur=sante&page=1" \ -H "Accept: application/json" # Réponse { "success": true, "data": [ ... ], "pagination": { "page": 1, "total": 248 } }
Retourne la liste paginée des structures essentielles publiées, avec filtres optionnels.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| page | integer | optionnel | Numéro de page (défaut : 1) |
| per_page | integer | optionnel | Résultats par page (défaut : 20, max : 100) |
| secteur | string | optionnel | sante education hydraulique energie |
| region_id | integer | optionnel | Filtrer par ID de région |
| etat | string | optionnel | operationnelle degradee fermee |
| search | string | optionnel | Recherche par nom ou type |
curl "https://estructuretchad.com/api/v1/structures?secteur=sante®ion_id=1&page=1"
{
"success": true,
"data": [
{
"id": 1,
"nom": "Hôpital Général de Référence de N'Djaména",
"type_structure": "hopital_national",
"secteur": "sante",
"region_nom": "N'Djaména",
"etat_fonctionnel": "operationnelle",
"latitude": 12.1048,
"longitude": 15.0445
}
],
"pagination": {
"page": 1, "per_page": 20,
"total": 248, "total_pages": 13
}
}
Retourne toutes les informations d'une structure, incluant photos et données sectorielles.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| id | integer | requis | Identifiant unique de la structure |
curl "https://estructuretchad.com/api/v1/structures/1"
Retourne les 23 régions administratives du Tchad avec chef-lieu, population et superficie.
curl "https://estructuretchad.com/api/v1/geo/regions"
{
"success": true,
"data": [
{ "id": 1, "nom": "N'Djaména", "code_region": "NDJ", "population": 1092066 }
]
}Retourne les préfectures, filtrable par région avec region_id.
curl "https://estructuretchad.com/api/v1/geo/prefectures?region_id=1"
Retourne les sous-préfectures, filtrable par préfecture avec prefecture_id.
curl "https://estructuretchad.com/api/v1/geo/sous-prefectures?prefecture_id=3"
Totaux nationaux par secteur — utilisé pour la page d'accueil et les tableaux de bord.
curl "https://estructuretchad.com/api/v1/stats/national"
{
"success": true,
"data": {
"total_structures": 1847, "total_regions": 23,
"par_secteur": { "sante": 512, "education": 748, "hydraulique": 423, "energie": 164 }
}
}Nombre de structures par région — utile pour les visualisations cartographiques.
curl "https://estructuretchad.com/api/v1/stats/par-region"
Retourne un GeoJSON FeatureCollection des structures géolocalisées. Compatible Leaflet, Mapbox, QGIS, Python geopandas.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| secteur | string | optionnel | Filtrer par secteur |
| region_id | integer | optionnel | Filtrer par région |
// Charger les structures sur une carte Leaflet fetch('/api/v1/geo/carte?secteur=sante') .then(r => r.json()) .then(geojson => { L.geoJSON(geojson, { pointToLayer: (f, ll) => L.circleMarker(ll, { radius: 6, fillColor: '#dc2626' }) }).addTo(map); });
Télécharge toutes les structures en CSV — compatible Excel, LibreOffice et Python pandas.
# Télécharger le CSV curl -O "https://estructuretchad.com/api/v1/exports/csv" # Python pandas import pandas as pd df = pd.read_csv('https://estructuretchad.com/api/v1/exports/csv') print(df.head())