Développeurs
API REST v1.
Bearer Sanctum · webhooks HMAC · WhatsApp inbound · plan Entreprise
OpenAPI 3
Spec YAML complète — import Swagger, Insomnia, SDK…
Télécharger .yaml →Collection Postman
Endpoints principaux prêts à tester (me, clients, ventes…)
Télécharger .json →Démarrer
- Paramètres → API → créer un token (lecture ou lecture+écriture)
- Importer le fichier OpenAPI ou Postman
- Renseigner
tokenetstore_id
Headers
Authorization: Bearer VOTRE_TOKEN Accept: application/json X-Store-Id: 12 # boutique (obligatoire en écriture) X-Store-Id: all # consolidé lecture seule
Endpoints principaux
- GET /api/v1/me
- GET /api/v1/stores
- GET|POST /api/v1/customers · GET|PATCH /api/v1/customers/{id}
- GET|POST /api/v1/products · GET|PATCH /api/v1/products/{id}
- GET|POST /api/v1/sales · POST /api/v1/sales/{id}/payments
- GET|POST /api/v1/quotes · POST /api/v1/quotes/{id}/convert-to-sale
- GET /api/v1/invoices
- GET /api/v1/reports/summary · /reports/holding
- POST|DELETE /api/v1/devices
Exemple curl
curl -s "http://www.jokkocrm.com/api/v1/sales?from=2026-07-01" \ -H "Authorization: Bearer VOTRE_TOKEN" \ -H "Accept: application/json" \ -H "X-Store-Id: all"
Limite : 60 req/min. Réponse : { "data": …, "meta": … }
Webhooks sortants
Plan Entreprise — Paramètres → Webhooks. Jokko POST un JSON signé vers votre URL (Make, Zapier, backend).
Événements
- customer.created
- sale.created
- deal.won · deal.lost
- quote.accepted
Headers
Content-Type: application/json X-Jokko-Event: sale.created X-Jokko-Signature: sha256=<hmac_sha256(body, secret)> User-Agent: JokkoCRM-Webhooks/1.0
Payload
{
"id": "uuid",
"event": "sale.created",
"created_at": "2026-07-24T02:00:00+00:00",
"organization_id": 1,
"data": { … }
}
WhatsApp Cloud API inbound : GET|POST /webhooks/whatsapp/{organization} (verify token Meta).