Référence API

Intégrez les données publiques de la RDC dans vos applications en quelques minutes.

URL de base

https://api.congodata.app/v1

Authentification

L'API est gratuite jusqu'à 60 requêtes par minute sans clé API. Pour des limites plus élevées, créez un compte et générez une clé.

Authorization: Bearer VOTRE_CLE_API

Niveau	Limite	Clé API
Gratuit	60 req/min	Non requise
Compte	600 req/min	Créer un compte

Endpoints

GET/datasetsLister les jeux de données

Retourne la liste paginée des jeux de données publics. Filtrez par secteur ou effectuez une recherche plein-texte.

Paramètres

Nom	Type	Description
`sector`	string	Filtrer par secteur (elections, health, education…)
`q`	string	Recherche plein-texte bilingue
`limit`	integer	Résultats par page (défaut: 20, max: 100)
`offset`	integer	Décalage de pagination

Exemple

GET

https://api.congodata.app/v1/datasets?sector=health&limit=5

Réponse (200)

200 OK

{
  "data": [
    {
      "id": "...",
      "slug": "health-facilities-drc-2024",
      "title_fr": "Établissements de santé en RDC 2024",
      "title_en": "DRC Health Facilities 2024",
      "sector": "health",
      "format": "csv",
      "license": "CC-BY-4.0",
      "access_level": "public",
      "updated_at": "2024-11-01T00:00:00Z"
    }
  ],
  "total": 18,
  "limit": 20,
  "offset": 0
}

GET/datasets/{slug}Obtenir un jeu de données

Retourne les métadonnées complètes d'un jeu de données par son slug unique.

Paramètres

Nom	Type	Description
`slug`requis	string	Identifiant unique du jeu de données

Exemple

GET

https://api.congodata.app/v1/datasets/health-facilities-drc-2024

Réponse (200)

200 OK

{
  "id": "...",
  "slug": "health-facilities-drc-2024",
  "title_fr": "Établissements de santé en RDC 2024",
  "title_en": "DRC Health Facilities 2024",
  "description_fr": "Localisation et type des établissements...",
  "description_en": "Location and type of health facilities...",
  "sector": "health",
  "format": "csv",
  "license": "CC-BY-4.0",
  "access_level": "public",
  "source_id": "opencongodata-team",
  "updated_at": "2024-11-01T00:00:00Z"
}

GET/datasets/{slug}/dataInterroger les données

⚠️ Non encore implémenté — retourne toujours un tableau vide. L'accès aux lignes de données est prévu pour une version future.

Paramètres

Nom	Type	Description
`slug`requis	string	Identifiant unique du jeu de données
`limit`	integer	Lignes par page (défaut: 100, max: 1000)

Exemple

GET

https://api.congodata.app/v1/datasets/health-facilities-drc-2024/data?limit=10

Réponse (200)

200 OK

{
  "data": [
    {
      "id": "H001",
      "name": "HGR Kinshasa",
      "type": "Hospital",
      "province": "Kinshasa",
      "territory": "Kinshasa",
      "operational": true
    }
  ]
}

Codes d'erreur

Code	Meaning
400	Paramètre invalide
404	Jeu de données introuvable
429	Limite de taux dépassée — réessayez après un délai
500	Erreur interne — réessayez

Toutes les erreurs suivent le format RFC 7807 Problem Details avec les champs type, title et detail.