Guida rapida

Verifica la tua chiave

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

La risposta indica il negozio, la sua currency di base (tutti i prezzi dei prodotti sono in questa valuta) e i permessi della tua chiave.

Visualizza i tuoi account canale collegati

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

Conserva l'id. Identifica esattamente questo account, anche se hai più account sullo stesso canale.

Crea un prodotto

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

Ricevi subito 201 con il prodotto completo, perché la scrittura locale è sincrona. Il prodotto esiste in Nembol ma non è ancora su nessun canale.

Pubblicalo su un canale

Un'inserzione (listing) è un prodotto su un account canale. Creane una:

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 risposta è 202. La pubblicazione passa dai worker di canale di Nembol:

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

Inviando di nuovo la stessa coppia (product_id, channel_account_id) ricevi questa stessa inserzione, senza duplicati.

Guardalo andare online

Interroga l'inserzione (o, meglio, iscriviti al 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 passa da ongoing a listed. Se il canale la rifiuta, ricevi status: "error" con il motivo in issues[]. Fatto. Il tuo prodotto è online.