Premiers pas

Prérequis

Parcours Plus (sans clé API)

1. 1

   Ouvrir le panneau Développeur

   njanggo.com → calendrier → Paramètres → Développeur (Plus ou Pro requis).

2. 2

   Configurer un webhook (aujourd’hui par événement)

   Gérer l'événement → Webhooks. Collez l'URL Zapier/Make, cochez guest.registered, copiez le secret whsec_… (une fois).

3. 3

   Tester la réception

   Bouton Tester ou inscription test. Vérifiez le JSON et la signature HMAC (X-Njanggo-Webhook-Signature).

4. 4

   Widget sur votre site

   Onglet Intégrer — copiez le code iframe du calendrier (aucune authentification).

Parcours Pro (API REST)

1. 1

   Générer une clé API

   Panneau Développeur → Clés API → Créer. Nommez la clé (ex. « CRM prod »). Sélectionnez les scopes minimums nécessaires.

2. 2

   Stocker la clé

   Exportez nj_live_… dans vos secrets (Vercel, Railway, .env serveur). Jamais dans le code front-end ou une app mobile distribuée.

3. 3

   Valider l'authentification

   Appelez GET /v1/calendars/:slug — vous devez recevoir les infos du calendrier.

4. 4

   Intégrer vos workflows

   Consultez les guides Événements, Invités, Check-in selon votre cas d'usage (CMS, kiosque, sync ventes).

Tester un webhook (Plus)

curl -X POST "https://api.njanggo.com/api/events/evt_abc123/webhooks" \
  -H "Authorization: Bearer $NJANGGO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hooks.zapier.com/hooks/catch/123456/abcdef/","events":["guest.registered"]}'

Tester l'API Pro

curl -X GET "https://api.njanggo.com/api/v1/calendars/mon-collectif" \
  -H "x-njanggo-api-key: $NJANGGO_API_KEY"

{
  "data": {
    "slug": "mon-collectif",
    "name": "Mon Collectif",
    "billingPlanCode": "PRO",
    "subscriberCount": 842
  }
}