Se connecterEssai gratuit →
Retour à l'accueil

API Développeurs

Branchez MyBiashara à tout.

API REST documentée OpenAPI 3.1, webhooks temps réel, SDKs TypeScript/Python/PHP, CLI, dashboard. Construisez vos intégrations sur des fondations propres.

Sortie publique Q1 2027

Capacités

REST API documentée

OpenAPI 3.1 spec versionnée. Tous les endpoints documentés avec exemples curl, JS, Python.

Webhooks temps réel

20+ events disponibles. Signature HMAC, retry exponentiel, replay 7 jours, dashboard logs.

OAuth2 + API Keys

Auth sécurisée. Tokens scopés par permission, rotation depuis dashboard, audit trail complet.

Rate limiting

1000 req/min STARTER, 10k PRO, illimité BUSINESS. Headers X-RateLimit explicites.

GraphQL bientôt

Endpoint /v1/graphql optionnel pour requêtes complexes. Préview Q2 2027.

CDN multi-régions

Cloudflare 50+ POP. Latence < 100ms partout en Afrique et au-delà.

Exemple d'intégration

Une vente complète en 15 lignes

sale-create.tsTypeScript
// Créer une vente avec multi-paiements
import { MyBiashara } from '@mybiasharas/sdk';

const mb = new MyBiashara({ apiKey: process.env.MB_KEY });

const sale = await mb.sales.create({
  items: [
    { productId: 'prd_abc', quantity: 2 },
    { productId: 'prd_xyz', quantity: 1 },
  ],
  payments: [
    { method: 'M_PESA',  amountCents: 5000 },
    { method: 'CASH',    amountCents: 2500 },
  ],
  customerId: 'cus_jane',
  branchId:   'brn_kin_centre',
});

console.log(sale.invoiceNumber); // INV-2026-001234

API REST v1

15 endpoints en aperçu (sur 75+)

Ventes
GET/salesLister les ventes avec filtres
POST/salesCréer une vente complète
GET/sales/{id}Détail d'une vente
POST/sales/{id}/refundRembourser une vente
Produits
GET/productsLister le catalogue
POST/productsCréer un produit
PUT/products/{id}Mettre à jour un produit
DELETE/products/{id}Supprimer (soft) un produit
Clients
GET/customersLister les clients CRM
POST/customers/{id}/creditArdoise / crédit client
Paiements
POST/payments/mpesaInitier paiement M-Pesa
POST/payments/orangeInitier Orange Money
Analytics
GET/analytics/salesStats agrégées de ventes
GET/analytics/top-productsTop produits par période
Webhooks
POST/webhooksSouscrire à un événement

Spec OpenAPI complète disponible à la sortie publique Q1 2027

Webhooks events

15 événements à brancher

Souscrivez à un endpoint HTTPS, recevez les events en temps réel. Signature HMAC, retry exponentiel.

sale.created
sale.refunded
product.low_stock
product.expired
payment.received
payment.failed
customer.created
customer.credit_limit_exceeded
invoice.sent
cash_drawer.opened
cash_drawer.closed
cash_drawer.discrepancy
sms.sent
whatsapp.delivered
user.role_changed

SDKs & outils

SDK TypeScript

Q1 2027
@mybiasharas/sdk · npm install

SDK Python

Q2 2027
pip install mybiasharas

SDK PHP

Q2 2027
composer require mybiasharas/sdk

CLI mybiasharas

Q1 2027
npx @mybiasharas/cli login

Postman collection

Q1 2027
75+ endpoints prêts à tester

GitHub repo demos

Q2 2027
Apps exemples Next.js, FastAPI, Laravel

Intéressé par l'accès anticipé ?

Inscrivez-vous à la liste d'attente pour les intégrateurs. Vous recevrez l'accès dès la sortie de la v1 — et vous pouvez voter sur les features prioritaires.

Rejoindre la liste d'attente