KPɔ̀N — La réalité du terrain, en données.
Se connecter

API REST

Vos données terrain, directement dans vos outils.

Une API REST sécurisée pour connecter KPɔ̀N à votre ERP, à vos tableaux de bord BI ou à votre entrepôt de données. Les mêmes données vérifiées que dans votre espace, sans export manuel.

Créer une clé d'API Documentation interactive

Ce que permet l'API

Soumissions vérifiées

Réponses, positions GPS, statut de revue et liens temporaires vers les preuves photo et audio.

Synchronisation incrémentale

Ne récupérez que ce qui a changé grâce au filtre updated_since, idéal pour une tâche planifiée.

Analyses agrégées

Indicateurs de campagne et couverture par département, commune, arrondissement ou quartier.

Format standard

JSON paginé, schéma OpenAPI 3 et documentation interactive pour générer votre client.

Exemple

curl "https://kpon-api.theringconcept.com/api/public/v1/submissions/\
  ?status=APPROVED&updated_since=2026-10-01T00:00:00Z" \
  -H "Authorization: Bearer kpon_••••••••"

{
  "count": 128,
  "next": ".../submissions/?page=2",
  "results": [
    {
      "id": "8f1c…",
      "status": "APPROVED",
      "campaign": { "name": "Relevé des prix" },
      "mission": { "commune": "Cotonou", "neighborhood": "Akpakpa" },
      "gps_check": { "status": "OK", "distance_m": 18 },
      "submitted_at": "2026-10-08T09:55:12Z"
    }
  ]
}

Démarrer en trois étapes

  1. 1

    Créez une clé

    Dans votre espace organisation, Paramètres → API : choisissez les droits, l'expiration et, si besoin, les adresses IP autorisées.

  2. 2

    Appelez l'API

    Ajoutez l'en-tête Authorization: Bearer suivi de votre clé à chaque requête HTTPS.

  3. 3

    Intégrez

    Planifiez une synchronisation ou branchez directement Power BI, Excel, Metabase ou votre propre code.

Points d'accès

Base : /api/public/v1 — lecture seule, limitée aux données de votre organisation.

GET/me/

Organisation et droits de la clé utilisée.

—
GET/campaigns/

Liste et détail de vos campagnes.

campaigns:read
GET/submissions/

Soumissions filtrables par campagne, statut et date.

submissions:read
GET/submissions/{id}/

Réponses, position et preuves d'une soumission.

submissions:read
GET/analytics/overview/

Indicateurs agrégés.

analytics:read
GET/analytics/territorial/

Couverture et validation par territoire.

analytics:read

Sécurité

  • Clé affichée une seule fois et stockée uniquement sous forme d'empreinte SHA-256.
  • Droits (scopes) limités par clé, en lecture seule.
  • Restriction par adresse IP ou plage CIDR, expiration automatique.
  • Révocation immédiate par l'organisation ou par KPɔ̀N.
  • Quota de 120 requêtes par minute et par clé, HTTPS obligatoire.
  • Agents pseudonymisés : ni nom ni NIP dans les réponses.
  • Création et révocation des clés inscrites au journal d'audit.
Documentation interactive