Schnellstart

Prüfe deinen Schlüssel

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

Die Antwort nennt dir den Shop, seine Basiswährung currency (alle Produktpreise sind in dieser Währung) und die Scopes deines Schlüssels.

Sieh dir deine verbundenen Kanalkonten an

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

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

Merk dir die id. Sie identifiziert genau dieses Konto, auch wenn du mehrere Konten auf demselben Kanal hast.

Erstelle ein Produkt

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" }]
  }'

Du erhältst sofort 201 mit dem vollständigen Produkt zurück, denn der lokale Schreibvorgang ist synchron. Das Produkt existiert in Nembol, ist aber noch auf keinem Kanal.

Veröffentliche es auf einem Kanal

Ein Angebot (Listing) ist ein Produkt auf einem Kanalkonto. Erstelle eines:

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"
  }'

Die Antwort ist 202. Die Veröffentlichung läuft über Nembols Kanal-Worker:

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

Sendest du dasselbe Paar (product_id, channel_account_id) erneut, erhältst du dasselbe Angebot zurück, ohne Duplikate.

Sieh zu, wie es live geht

Frag das Angebot regelmäßig ab (oder, besser, abonniere den Webhook listing.status_changed):

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

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

status wechselt von ongoing → listed. Lehnt der Kanal es ab, erhältst du status: "error" mit dem Grund in issues[]. Fertig. Dein Produkt ist live.