API & intégrations

Intégrez les données Zekin dans vos plateformes.

L’API Zekin expose en lecture les événements, éditions, catégories et nominés publiés sur la plateforme, au format JSON.

Explorer l’API →

Aperçu

L’API est accessible à l’adresse /api/v1. Elle ne nécessite pas encore de clé d’API — l’authentification pour les intégrations tierces fait partie de notre feuille de route.

Format de réponse — succès

{
  "success": true,
  "message": "...",
  "data": { /* ... */ },
  "meta": { "page": 1, "limit": 50, "total": 12, "totalPages": 1 }
}

Chaque liste accepte les paramètres page, limit et search.

Événements

GET/api/v1/events?status=publishedListe des événements publiés

{
  "success": true,
  "data": [
    {
      "_id": "665f1c...",
      "name": "Vibrations Vocales",
      "slug": "vibrations-vocales",
      "status": "published",
      "organization": { "name": "..." }
    }
  ]
}

GET/api/v1/editions?event={eventId}&status=activeÉdition active d'un événement

{
  "success": true,
  "data": [
    {
      "_id": "665f2a...",
      "slug": "vibrations-vocales/edition-3",
      "editionNumber": 3,
      "country": "BJ",
      "votePrice": 200,
      "currency": "XOF",
      "startDate": "2026-08-01T00:00:00Z",
      "endDate": "2026-08-30T23:59:59Z",
      "status": "active"
    }
  ]
}

Catégories

GET/api/v1/categories?editionId={editionId}&status=activeCatégories actives d'une édition

{
  "success": true,
  "data": [
    { "_id": "665f3b...", "name": "Meilleure artiste féminine", "status": "active" }
  ]
}

Nominés

GET/api/v1/nominees?editionId={editionId}&status=activeNominés actifs d'une édition

{
  "success": true,
  "data": [
    {
      "_id": "665f4c...",
      "pseudo": "Aminata K.",
      "category": { "name": "Meilleure artiste féminine" },
      "imageUrl": "https://.../uploads/nominees/images/..."
    }
  ]
}

Le vote en ligne et le paiement associé arrivent dans une prochaine version de la plateforme — cette page sera mise à jour dès leur ouverture publique.

Une question sur l’intégration ?

Notre équipe technique vous répond directement.

Contacter l’équipe dev