API partenaire

Base : https://backend.generale-ci.com

Obtenir une clé

Espace vendeur → Boutique → Boutique en ligne → Clés d’API. La clé n’est affichée qu’une fois — conserve-la.

Chaque clé porte des scopes : items:read, items:write, orders:read, orders:write. Ne demande que ce dont tu as besoin ; un appel hors scope répond 403 avec un message en français.

Authentification

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"

Endpoints

Méthode	Chemin	Scope	Rôle
`GET`	`/partner/v1/items`	`items:read`	Catalogue (pagination par curseur)
`POST`	`/partner/v1/items`	`items:write`	Créer un article
`PATCH`	`/partner/v1/items/:id`	`items:write`	Mettre à jour (prix, stock…)
`DELETE`	`/partner/v1/items/:id`	`items:write`	Retirer un article
`GET`	`/partner/v1/orders`	`orders:read`	Tes commandes
`POST`	`/partner/v1/orders/:id/advance`	`orders:write`	Faire avancer une commande

Pagination

La pagination utilise un curseur (pas de numéro de page) : la réponse contient nextCursor, à repasser tel quel en paramètre cursor. Quand nextCursor est absent ou nul, tu es au bout.

JavaScript

let cursor;
do {
  const url = new URL('https://backend.generale-ci.com/partner/v1/items');
  if (cursor) url.searchParams.set('cursor', cursor);
  const page = await fetch(url, { headers: { 'X-Api-Key': cle } }).then((r) => r.json());
  traiter(page.items);
  cursor = page.nextCursor;
} while (cursor);

Essayer les endpoints

Lister le catalogue

GET/partner/v1/itemsEssayer

X-Api-Key — ta clé (gardée uniquement dans cet onglet)?limit — taille de 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'

Mettre à jour un article

Envoi partiel : n’envoie que les champs qui changent (le prix, le stock…).

PATCH/partner/v1/items/:idEssayer

X-Api-Key — ta clé (gardée uniquement dans cet onglet)id — identifiant de l’article chez nousCorps JSON

Colle ta clé d’API d’abord.

Commande cURL équivalente

curl -X PATCH 'https://backend.generale-ci.com/partner/v1/items/:id' \
  -H 'X-Api-Key: VOTRE_CLE' \
  -H 'Content-Type: application/json' \
  -d '{
  "price": 25000,
  "stock": 3
}'

Lister les commandes

GET/partner/v1/ordersEssayer

X-Api-Key — ta clé (gardée uniquement dans cet onglet)?limit — taille de 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/orders' \
  -H 'X-Api-Key: VOTRE_CLE'

Faire avancer une commande depuis ton système

POST /partner/v1/orders/:id/advance fait passer la commande à l’étape suivante : Confirmée → En préparation → En livraison → Livrée. Un appel = un cran. On n’autorise pas de sauter des étapes, et le client est notifié à chaque passage.

POST/partner/v1/orders/:id/advanceEssayer

X-Api-Key — ta clé (gardée uniquement dans cet onglet)id — identifiant de la commande

Colle ta clé d’API d’abord.

Commande cURL équivalente

curl -X POST 'https://backend.generale-ci.com/partner/v1/orders/:id/advance' \
  -H 'X-Api-Key: VOTRE_CLE'