Démarrage rapide

Trois étapes : une clé, un appel, un webhook.

1. Obtenir une clé d’API

Dans l’application Générale CI : Espace vendeur → Boutique → Boutique en ligne → Clés d’API.

La clé n’est affichée qu’une fois — conserve-la immédiatement dans ton gestionnaire de secrets.

Chaque clé porte des scopes : items:read, items:write, orders:read, orders:write. Ne demande que ce dont tu as besoin.

Toutes les requêtes portent l’en-tête X-Api-Key.

Terminal

curl https://backend.generale-ci.com/partner/v1/items \
  -H "X-Api-Key: VOTRE_CLE"

Essaie-le tout de suite, avec ta clé :

GET/partner/v1/itemsEssayer

X-Api-Key — ta clé (gardée uniquement dans cet onglet)?limit — nombre d’articles par page?cursor — valeur `nextCursor` de la page précédente

Colle ta clé d’API d’abord.

Commande cURL équivalente

curl -X GET 'https://backend.generale-ci.com/partner/v1/items' \
  -H 'X-Api-Key: VOTRE_CLE'

Abonne ton serveur à l’évènement ORDER_CREATED, vérifie la signature, réponds 200. Tout est détaillé dans Webhooks sortants.

JSON

{ "url": "https://ma-boutique.ci/webhooks/generale-ci", "events": ["ORDER_CREATED"] }

Ensuite, avec une clé sandbox, déclenche une commande de test et regarde ton endpoint être appelé en direct : Tester sans risque.