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, 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.
- 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.
Démarrage rapide
Crée une clé, fais ton premier appel et lis la réponse.
Référence de l’API
Chaque opération avec sa portée, un exemple curl et une réponse d’exemple.
Webhooks
Reçois tes ventes en direct et vérifie qu’elles viennent bien de Kivoo.
Un premier appel
Les dix dernières commandes payées de ta boutique :
curl --get https://api.kivoo.africa/v1/orders \
-H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000" \
-H "Accept: application/json" \
-d status=PAID \
-d pageSize=10La 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.