Premiers appels

Validez votre intégration en effectuant deux appels simples : récupérer la liste de vos contacts, puis pousser un client.

Prérequis

• Un compte ShopiMind actif.
• Une clé API générée depuis votre dashboard.

Lister vos contacts

L'exemple ci-dessous récupère les 50 premiers contacts de votre boutique :

curl -X GET 'https://core.shopimind.com/v1/contacts' \
  -H 'spm-api-key: VOTRE_CLE_API' \
  -H 'Accept: application/json'

La réponse contient un tableau data avec les contacts et un bloc meta.pagination indiquant la position dans la pagination. Voir Format des réponses pour le détail du schéma.

Pousser un client

Pour synchroniser un client e-commerce vers ShopiMind, utilisez l'endpoint bulkCreateCustomers. Les écritures sont toujours en lot (jusqu'à 50 clients par appel), même pour un seul item :

curl -X POST 'https://core.shopimind.com/v1/customers' \
  -H 'spm-api-key: VOTRE_CLE_API' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "customer_id": "CUST-001",
      "email": "marie.dupont@example.com",
      "first_name": "Marie",
      "last_name": "Dupont",
      "lang": "fr",
      "is_newsletter_subscribed": true,
      "created_at": "2026-05-07T08:00:00.000Z",
      "updated_at": "2026-05-07T08:00:00.000Z"
    }
  ]'

La réponse confirme l'acceptation et indique combien d'items ont été acceptés ou rejetés :

{
  "statusCode": 200,
  "sent_count": 1,
  "rejected_count": 0,
  "rejected_items": []
}

Traitement asynchrone

Une réponse 200 confirme que votre requête a été acceptée et mise en file de traitement. Le client peut mettre quelques secondes à apparaître sur les lectures suivantes (listCustomers / getCustomer).

Et ensuite ?

• Référence complète des endpoints — chaque ressource détaillée dans la sidebar.
• Connecteur e-commerce — synchroniser l'ensemble de votre boutique.
• Données personnalisées — modéliser vos données métier dans ShopiMind.