Tradotta dall'inglese. In caso di differenze fa fede la pagina in inglese. Leggi in inglese
Testa la tua integrazione
Due modi per testare senza conseguenze per nessuno: chiavi di test per verificare le singole richieste, e una sandbox per eseguire l'intera integrazione per davvero senza addebiti.
Ci sono due modi per testare, e rispondono a domande diverse:
- Le chiavi di test rispondono a "questa richiesta è corretta?" Ogni chiamata viene verificata e simulata, nulla viene salvato.
- La sandbox (per i partner) risponde a "la mia integrazione funziona nel suo insieme?" Tutto avviene per davvero, con aziende, canali, webhook e ordini reali, ma nulla viene fatturato.
La maggior parte delle integrazioni usa entrambi: le chiavi di test mentre scrivi ogni chiamata, la sandbox per eseguire l'intero flusso end to end prima di andare live.
In sintesi
Chiave di test (nbl_test_…) | Partner in sandbox (chiave live) | |
|---|---|---|
| Chi | Tutti | Partner (accounts:manage) |
| Richieste validate | Sì, esattamente come in live | Sì, è live |
| Dati salvati | No. Un prodotto che "crei" non si può rileggere | Sì |
| Canali (Shopify, eBay…) | Mai toccati; risultati contrassegnati come "simulated" | Aggiornati davvero. Collega negozi di test |
| Webhook ed eventi | Nessuno | Sì, come in live (account_id su ogni evento di un'azienda) |
Aziende (POST /accounts) | Simulate (acct_test, "simulated": true). Non puoi operare al suo interno | Reali, al massimo 3 aperte contemporaneamente |
| Fatturazione | Mai | Mai. L'estratto conto mostra 0 e sandbox: true |
| Passaggio al live | Passa alla tua chiave nbl_live_ | Passa al live nella dashboard; stessa chiave, stesse aziende |
Chiavi di test
Creane una in Impostazioni → Sviluppatori (modalità Test). Usala esattamente come una chiave live:
curl -X POST https://api.nembol.com/rest/v1/products \
-H "Authorization: Bearer nbl_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"title": "Test mug", "variants": [{"sku": "MUG-1", "price": "12.00", "quantity": 5}]}'La risposta ha la forma che restituirebbe una chiamata live, con "simulated": true.
Gli errori sono reali: un campo mancante, un formato di prezzo errato o un permesso
mancante rispondono esattamente come in live.
Cosa non fa una chiave di test:
- Nulla viene salvato. Le chiamate di lettura restituiscono i dati reali del tuo negozio, quindi un
prodotto simulato non compare mai in
GET /products. Testa ogni scrittura singolarmente; non concatenare "crea, poi rileggi". - Nessun canale viene contattato, nessun ordine viene spedito, nessuna email viene inviata.
- Nessun evento o webhook viene prodotto dalle chiamate simulate.
Sandbox (partner)
La sandbox è il tuo account partner con la fatturazione disattivata. Tutto funziona come in live (è proprio questo lo scopo), così puoi costruire l'intera integrazione e vederla in funzione:
- Il tuo account partner parte in sandbox: Nembol lo attiva
così. Verificalo con
GET /partner/billing, che risponde"sandbox": truee"sandbox_max_accounts": 3. - Crea fino a 3 aziende con
POST /accounts. Una 4ª azienda aperta risponde409 sandbox_limit. Chiudine una (POST /accounts/{id}/close) per liberare un posto. - Collega negozi di test, non negozi reali: un development store Shopify, un account di test eBay o Etsy, un sito WooCommerce di tua proprietà. Inserzioni, scorte e ordini li raggiungono davvero. I marketplace con acquirenti (Amazon, TikTok Shop) sono marketplace reali, quindi pubblica con attenzione e rimuovi le inserzioni quando hai finito.
- Ricevi i webhook e fai polling esattamente come in produzione: gli eventi di ogni azienda
arrivano ai tuoi endpoint con
account_id. - Controlla l'estratto conto:
GET /partner/statementelenca le tue aziende con importo 0 e"sandbox": true.
Passare al live
Quando la tua integrazione è pronta, passa al live da solo dalla dashboard: Impostazioni → Partner → Passa al live (nell'avviso Sandbox).
- Se paghi con carta, aggiungi prima una carta. Nembol apre una pagina Stripe sicura che salva la carta senza addebitare nulla.
- Conferma. La finestra mostra quante aziende sono aperte e quanto costano al mese alle tue tariffe. La fatturazione parte quel giorno, calcolata pro rata giornaliera.
- A quel punto
GET /partner/billingrisponde"sandbox": false.
La tua chiave, le tue aziende, i loro canali e i tuoi webhook restano esattamente come sono, senza nulla da migrare. Chiudi le aziende di test che non vuoi vedere fatturate prima di passare al live.
Il passaggio al live è a senso unico: tornare indietro fermerebbe la fatturazione delle aziende live, quindi per tornare alla sandbox scrivi a developer@nembol.com. Di proposito non è disponibile dall'API: la fatturazione non parte mai per errore da uno script.
Quale usare e quando
- Scrivi una nuova chiamata o un nuovo ramo di gestione errori → chiave di test.
- Verifichi che un handler webhook, il flusso di collegamento (link di ritorno), il polling degli ordini e l'evasione funzionino insieme → sandbox.
- Un'integrazione solo venditore (senza programma partner) → chiave di test, poi una chiave live su un negozio di test collegato al tuo negozio Nembol.
Ultimo aggiornamento il 20 ottobre 2026