Démarrage rapide

Traduite de l'anglais. En cas de différence, la page en anglais fait foi. Lire en anglais

À la fin de cette page, vous aurez créé un produit via l'API et l'aurez publié sur l'un de vos canaux connectés, en voyant son statut passer de ongoing à listed.

Prérequis

Une boutique Nembol avec le plan Enterprise+. Pendant l'essai gratuit, quel que soit le plan, vous pouvez déjà utiliser des clés de test (nbl_test_) et un endpoint de webhook.
Au moins un canal connecté (page Canaux du tableau de bord).
Une clé API : tableau de bord → Paramètres → Développeurs → Créer la clé. Utilisez une clé nbl_test_ pendant l'intégration. Les clés de test valident tout mais ne touchent jamais vos canaux réels.

Utilisez votre clé dans les exemples

Collez une clé de test (nbl_test_…) et chaque bloc de code de ce site l'insère pour vous. Elle reste uniquement dans ce navigateur et n'est jamais envoyée.

Vérifiez votre clé

curl https://api.nembol.com/rest/v1/store \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

La réponse vous indique la boutique, sa devise de base currency (tous les prix des produits sont dans cette devise) et les scopes de votre clé.

Consultez vos comptes de canal connectés

Terminal

curl https://api.nembol.com/rest/v1/channel_accounts \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

Response

{
  "data": [
    {
      "id": "chac_66a1f09b2",
      "object": "channel_account",
      "channel": "shopify",
      "label": "Shopify",
      "shop_name": "acme-vintage",
      "status": "connected"
    }
  ]
}

Conservez l'id. Il identifie précisément ce compte, même si vous avez plusieurs comptes sur le même canal.

Créez un produit

curl -X POST https://api.nembol.com/rest/v1/products \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-001" \
  -d '{
    "title": "Vintage denim jacket",
    "description": "Classic 90s denim jacket, size M.",
    "price": "49.90",
    "quantity": 3,
    "sku": "VDJ-M-001",
    "images": [{ "url": "https://example.com/jacket.jpg" }]
  }'

Vous recevez immédiatement 201 avec le produit complet, car l'écriture locale est synchrone. Le produit existe dans Nembol mais n'est encore sur aucun canal.

Publiez-le sur un canal

Une annonce (listing) est un produit sur un compte de canal. Créez-en une :

curl -X POST https://api.nembol.com/rest/v1/listings \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-002" \
  -d '{
    "product_id": "prod_64a91c3f2",
    "channel_account_id": "chac_66a1f09b2"
  }'

La réponse est 202. La publication passe par les workers de canal de Nembol :

Response

{
  "id": "list_9ac2e",
  "object": "listing",
  "product_id": "prod_64a91c3f2",
  "channel_account_id": "chac_66a1f09b2",
  "channel": "shopify",
  "status": "ongoing"
}

Envoyer à nouveau la même paire (product_id, channel_account_id) renvoie cette même annonce, sans doublon.

Suivez sa mise en ligne

Interrogez l'annonce (ou, mieux, abonnez-vous au webhook listing.status_changed) :

Terminal

curl https://api.nembol.com/rest/v1/listings/list_9ac2e \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

Response

{
  "id": "list_9ac2e",
  "status": "listed",
  "id_on_channel": "8571…",
  "url_on_channel": "https://acme-vintage.myshopify.com/products/vintage-denim-jacket"
}

status passe de ongoing à listed. Si le canal la refuse, vous obtenez status: "error" avec la raison dans issues[]. C'est terminé : votre produit est en ligne.

Besoin d'aide ?

Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.

Écrivez-nous Statut de l'API

Vérifiez votre clé

Consultez vos comptes de canal connectés

Créez un produit

Publiez-le sur un canal

Suivez sa mise en ligne

Et ensuite

Concepts clés

Synchroniser l'inventaire

Webhooks

Erreurs

Sur cette page