Démarrage rapide

1. Crée une clé APICopier le lien de la section

Dans le dashboard Kivoo, ouvre ta boutique puis Paramètres › Développeur › Clés API, et clique sur Créer une clé.

1. Nom : l’outil qui utilisera la clé, par exemple « Zapier » ou « Mon site ». C’est ce nom qui apparaîtra dans le journal d’activité à chaque modification faite avec la clé.
2. Portées : pour chaque ressource (Boutique, Produits, Commandes, Acheteurs, Liens de paiement), aucun accès, lecture ou lecture et écriture. Pour ce guide, Boutique en lecture suffit. Les portées ne se modifient plus après la création : voir Authentification.
3. Expiration : jamais, 30 jours, 90 jours ou 1 an.

La clé complète, qui commence par kv_live_, s’affiche une seule fois. Copie-la et range-la tout de suite là où ton serveur lit ses secrets (une variable d’environnement, un gestionnaire de secrets) : Kivoo n’en garde qu’une empreinte et ne pourra plus te la montrer.

2. Fais ton premier appelCopier le lien de la section

Passe la clé dans l’en-tête Authorization, précédée de Bearer :

curl https://api.kivoo.africa/v1/store \
  -H "Authorization: Bearer kv_live_EXAMPLE0000000000000000000000000000000000"

Le même appel depuis Node.js (18 ou plus), la clé étant lue dans l’environnement :

const response = await fetch('https://api.kivoo.africa/v1/store', {
  headers: { Authorization: `Bearer ${process.env.KIVOO_API_KEY}` },
});
if (!response.ok) throw new Error(`Kivoo a répondu ${response.status}`);
const store = await response.json();
console.log(store.name, store.currency);

3. Lis la réponseCopier le lien de la section

Kivoo répond 200 avec la boutique à laquelle la clé appartient :

{
  "id": "6f1c2d3e-4b5a-4c6d-8e9f-0a1b2c3d4e5f",
  "name": "Atelier Nour",
  "slug": "atelier-nour",
  "url": "https://atelier-nour.kivoo.store",
  "description": "Guides et ateliers de couture.",
  "currency": "XAF",
  "country": "CM",
  "supportEmail": "contact@atelier-nour.cm",
  "phone": "+237655000000",
  "whatsappPhone": "+237655000000",
  "socialLinks": { "instagram": "https://instagram.com/atelier.nour" },
  "status": "open",
  "createdAt": "2026-03-01T09:30:00.000Z"
}

• id est un UUID : c’est lui qu’on retrouve dans les événements webhook (store.id).
• currency est la devise de tous les montants de la boutique, en unités mineures.
• createdAt est une date ISO 8601 en UTC, comme toutes les dates de l’API.

Si la clé est absente, fausse, révoquée ou expirée, Kivoo répond 401 avec un code qui dit pourquoi (api_key_missing, api_key_invalid…) ; les codes sont listés dans Conventions.

Et ensuiteCopier le lien de la section

• Parcours la référence de l’API : chaque opération donne la portée qu’elle demande.
• Pagine une liste de produits ou de commandes en suivant les conventions.
• Reçois chaque vente en direct avec les webhooks.