SDK officiels

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

Vous construisez une intégration ?

Si votre objectif est de brancher une plateforme (CRM, ERP, POS, e-commerce…) sur ShopiMind, n'utilisez pas le SDK seul : appuyez-vous sur le kit d'intégration JavaScript@shopimind/integration-kit-js, qui dépend du SDK et le ré-exporte pour vous, et qui gère le cycle de vie, les webhooks signés et la synchronisation des données. → Section Intégrations

SDK JavaScript / TypeScript

Disponible — package npm @shopimind/sdk-js.

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

import { SpmClient, SpmCustomers } from '@shopimind/sdk-js';

// Client for the v1 API, authenticated with the shop API key (spm-api-key header)
const client = SpmClient.getClient('v1', process.env.SHOPIMIND_API_KEY!);

// Read — paginated list
const res = await SpmCustomers.list(client, { limit: 50 });
if (!res.ok) {
  throw new Error(res.error.message); // the SDK never throws: check res.ok instead
}
console.log(res.data.data); // ⚠️ business payload is double-nested: res.data.data

// Batch write with automatic chunking
const saved = await SpmCustomers.bulkSave(client, customers, { chunk: true });

• Node.js 18+ · ESM uniquement (import) — pas de build CommonJS
• Types .d.ts inclus · dépendance runtime unique : axios
• Authentification par clé API de boutique dans l'en-tête spm-api-key
• Format de retour uniforme { ok, statusCode, data, error } — le SDK ne lève jamais d'exception sur une erreur HTTP ; le payload métier se trouve à res.data.data

→ 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.

SDK Go

Bientôt disponible

Le SDK Go officiel arrive prochainement. En attendant, appelez l'API directement depuis la Référence API.

Quel canal d'intégration choisir ?

Vous êtes…	Recommandation
Une app Node.js / TypeScript	SDK JavaScript @shopimind/sdk-js — le plus rapide et le plus robuste
Une plateforme à brancher sur ShopiMind (CRM, ERP, POS…)	Le kit d'intégration JavaScript @shopimind/integration-kit-js (il ré-exporte le SDK)
Une plateforme e-commerce autonome (PrestaShop, WooCommerce, Odoo…)	Un connecteur officiel ou sur mesure (construit avec le même kit)
Un autre langage / besoin bas niveau	L'API REST directement (cURL / PHP / HTTP), base https://core.shopimind.com/v1