SDKs officiels

Intégrez l'API ShopiMind sans réécrire la couche HTTP. Les SDKs officiels gèrent pour vous l'authentification, les retries automatiques, le découpage des gros lots (chunking), la pagination et un format de réponse uniforme — vous écrivez de la logique métier, pas de la plomberie réseau.

SDK JavaScript / TypeScript

Disponible — package npm @shopimind/sdk-shopimind.

npm install @shopimind/sdk-shopimind
# yarn add @shopimind/sdk-shopimind
# pnpm add @shopimind/sdk-shopimind

const { SpmClient, SpmCustomers } = require('@shopimind/sdk-shopimind');

const client = SpmClient.getClient('v1', process.env.SHOPIMIND_API_KEY);

// Lire
const page = await SpmCustomers.list(client, { limit: 50 });

// Écrire (avec découpage automatique des gros lots)
const res = await SpmCustomers.bulkSave(client, customers, { chunk: true });
if (res.ok) console.log(res.data.sent_count, res.data.rejected_count);

• Node.js ≥ 14 · CommonJS (require) et ESM / TypeScript (import)
• Types .d.ts inclus · dépendance runtime unique : axios
• Format de retour uniforme { ok, statusCode, data, error } — le SDK ne lève jamais d'exception sur une erreur HTTP

→ Documentation du SDK JavaScript

SDK PHP

Bientôt disponible

Le SDK PHP officiel arrive prochainement. En attendant, appelez l'API directement — chaque page de la Référence API fournit un exemple cURL et PHP prêt à l'emploi.

Quel canal d'intégration choisir ?

Vous êtes…	Recommandation
Une app Node.js / TypeScript	SDK JavaScript — le plus rapide et le plus robuste
Une boutique e-commerce standard	Un connecteur officiel (PrestaShop, WooCommerce, Shopify, Magento)
Un autre langage / besoin bas niveau	L'API REST directement (cURL / PHP / HTTP)