Développeurs

API REST v1.

Bearer Sanctum · webhooks HMAC · WhatsApp inbound · plan Entreprise

Démarrer

  1. Paramètres → API → créer un token (lecture ou lecture+écriture)
  2. Importer le fichier OpenAPI ou Postman
  3. Renseigner token et store_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).

← Retour documentation