Documentation développeur

Branche tes outils sur ta boutique Kivoo : lis tes commandes et tes acheteurs, gère tes produits et tes liens de paiement, reçois chaque vente en direct.

L’API Kivoo donne à tes programmes accès à ta boutique : un tableur qui se remplit à chaque vente, un CRM qui connaît tes acheteurs, un automate (Zapier, Make, n8n) qui publie tes produits, ton propre site. Elle vit sous https://api.kivoo.africa/v1, répond en JSON et s’authentifie avec une clé API de la boutique.

Ce que tu peux faire

  • Lire ta boutique, ses produits (produits à télécharger, événements, formations, licences), ses commandes, ses acheteurs et ses liens de paiement, avec pagination et recherche.
  • Modifier un produit (titre, textes, prix) et le publier, le repasser en brouillon ou l’archiver. Ce qu’il faut pour publier dépend de son type : voir Conventions.
  • Créer et modifier un acheteur, sans jamais créer de doublon.
  • Gérer tes liens de paiement : les créer, les modifier, les suspendre, les réactiver.
  • Recevoir les événements webhook de ta boutique (order.paid, customer.created…) sur ton serveur, signés, avec des tentatives automatiques.
  • Vendre des licences : vérifier depuis ton serveur la clé de licence qu’un acheteur saisit dans ton logiciel, ou faire payer les utilisateurs de ton application par une session de paiement.

Un premier appel

Les dix dernières commandes payées de ta boutique :

Terminal
curl --get https://api.kivoo.africa/v1/orders \
  -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \
  -H "Accept: application/json" \
  -d status=PAID \
  -d pageSize=10

La réponse liste les commandes (data), la page demandée et le nombre total (total) : les règles communes à toutes les listes sont dans Conventions.

Une clé n’ouvre qu’une boutique

Une clé API appartient à une seule boutique : les adresses de l’API ne portent donc jamais d’identifiant de boutique. Si tu gères deux boutiques, crée une clé dans chacune.

Sur cette page