Développeurs
API Boutiko
Reliez votre boutique à vos outils : facturation, tableur, automatisations. Les montants sont des entiers dans la monnaie de la boutique. L'API ne montre jamais la commission, le taux, le solde ni les retraits : seulement le prix payé et ce que vous recevez (seller_net).
Fichier OpenAPI (openapi.json)
Authentification
Créez une clé dans Réglages > Développeurs en choisissant ses permissions. Elle n'est affichée qu'une fois ; vous pouvez la révoquer à tout moment.
curl https://getboutiko.com/api/v1/produits \ -H "Authorization: Bearer bk_live_VOTRE_CLE"
Routes
- GET
/api/v1/boutiqueLa boutique de la clé ·produits:lecture - GET
/api/v1/produitsLister (filtres statut, type ; curseur) ·produits:lecture - POST
/api/v1/produitsCréer en brouillon (Idempotency-Key) ·produits:ecriture - GET
/api/v1/produits/{id}Détail ·produits:lecture - PATCH
/api/v1/produits/{id}Modifier ·produits:ecriture - POST
/api/v1/produits/{id}/publierPublier ·produits:ecriture - GET
/api/v1/commandesLister (statut, produit, du, au ; curseur) ·commandes:lecture - GET
/api/v1/commandes/{id}Détail ·commandes:lecture - POST
/api/v1/produits/{id}/depublierRemettre en brouillon ·produits:ecriture - GET
/api/v1/clientsLister les clients ·clients:lecture - GET
/api/v1/avisAvis publiés (filtre produit ; curseur) ·avis:lecture - GET
/api/v1/codes-promoCodes promo (lecture seule) ·promotions:lecture
Créer un produit
curl -X POST https://getboutiko.com/api/v1/produits \
-H "Authorization: Bearer bk_live_VOTRE_CLE" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: creation-guide-2026-11-10" \
-d '{"title":"Guide Excel","kind":"files","price":5000}'Le produit est créé en brouillon. Les règles du site s'appliquent : prix minimum, et pour publier un fichier, une leçon publiée ou les détails de la prestation. Même Idempotency-Key + même corps = même réponse (24 h).
Pagination, limites et erreurs
- Listes :
limit(1 à 100) etcursor= la valeurnext_cursorde la page précédente. - 120 requêtes par minute et par clé : en-têtes
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset; au-delà, 429. - Erreurs :
{"error":{"code":"introuvable","message":"…"}}— codes non_authentifie (401), permission_insuffisante (403), introuvable (404), requete_invalide (400), conflit (409), trop_de_requetes (429).
Webhooks
Événements : order.paid, order.refunded, product.published. Adresse https obligatoire. Chaque envoi porte l'en-tête Boutiko-Signature: t=HORODATAGE,v1=SIGNATURE : HMAC-SHA256 de HORODATAGE.CORPS avec votre secret whsec_…. Refusez les messages de plus de 5 minutes. En cas d'échec, nouveaux essais après 1 min, 5 min, 30 min, 2 h et 12 h.
// Node.js : vérifier la signature
import { createHmac, timingSafeEqual } from "node:crypto";
function verifier(corps, entete, secret) {
const { t, v1 } = Object.fromEntries(entete.split(",").map((p) => p.split("=")));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const attendu = createHmac("sha256", secret).update(`${t}.${corps}`).digest("hex");
return timingSafeEqual(Buffer.from(attendu), Buffer.from(v1));
}{
"id": "…", "type": "order.paid", "created_at": "2026-11-10T10:00:00Z",
"data": { "reference": "BK-7CCFF34E", "amount_paid": 5000, "seller_net": 4500, "currency": "XOF", … }
}