Tradotta dall'inglese. In caso di differenze fa fede la pagina in inglese. Leggi in inglese
Autenticazione
Chiavi API, permessi, modalità test e le regole di sicurezza che proteggono il tuo negozio.
Tutte le richieste sono autenticate con una chiave API legata al negozio, inviata come token Bearer:
curl https://api.nembol.com/rest/v1/store \
-H "Authorization: Bearer nbl_live_xxxxxxxxxxxxxxxxxxxxxxxx"Le chiavi vengono create dal proprietario del negozio nella dashboard Nembol, in Impostazioni → Sviluppatori. Il secret completo viene mostrato una sola volta, alla creazione. Conservalo in un secret manager. In seguito sono visibili solo il nome e il prefisso.
Modalità delle chiavi
| Prefisso | Modalità | Comportamento |
|---|---|---|
nbl_live_ | Live | Accesso completo; le scritture si propagano ai tuoi canali. |
nbl_test_ | Test | Tutto viene validato e simulato; nulla viene salvato e nessun canale viene mai toccato. I risultati simulati dei canali sono contrassegnati come "simulated". |
Integra prima con una chiave di test; passa a una chiave live quando i tuoi flussi funzionano. I partner possono anche eseguire l'intera integrazione per davvero, senza addebiti, nella sandbox.
Usa la tua chiave negli esempi
Incolla una chiave di test (nbl_test_…) e ogni blocco di codice di questo sito la inserisce per te. Resta solo in questo browser e non viene mai inviata.
Permessi (scope)
Ogni chiave ha solo i permessi che le concedi:
| Permesso | Consente |
|---|---|
products:read | Leggere prodotti, varianti, inserzioni |
products:write | Creare, aggiornare, eliminare prodotti e immagini |
inventory:write | Aggiornare solo quantità e prezzo (più sicuro per le integrazioni di sincronizzazione scorte) |
listings:write | Pubblicare e rimuovere dai canali, per canale |
orders:read | Leggere gli ordini. Include i dati personali degli acquirenti, quindi trattali in modo lecito |
orders:write | Segnare gli ordini come spediti, allegare il tracking, notificare il marketplace |
webhooks:manage | Gestire gli endpoint webhook |
events:read | Leggere il registro eventi |
channels:write | Modificare le impostazioni degli account canale: regole di sincronizzazione, regola di prezzo, limite di quantità, policy/collezione predefinite |
channels:connect | Collegare e scollegare account canale, gestire gli URL di reindirizzamento usati dai link di collegamento |
billing:read | Leggere piano, utilizzo, metodo di pagamento e fatture del negozio |
storefront:write | Impostazioni dello storefront (non i pagamenti), codici sconto e bundle |
promotions:write | Creare, modificare, fermare ed eliminare promozioni (saldi a tempo sui canali) |
billing:manage | Creare link per abbonarsi, cambiare piano, aggiornare la carta, disdire o rinnovare; riavviare la prova gratuita |
accounts:manage | Solo partner. Creare, modificare e chiudere le tue aziende, leggere l'estratto conto e la fatturazione partner, e operare all'interno di un'azienda con l'header Nembol-Account (senza questo permesso, ogni richiesta con quell'header risponde 403 insufficient_scope). Compare in Impostazioni → Sviluppatori solo su un account partner, ed è incluso nel preset Lettura e scrittura. Vedi Programma partner. |
Le richieste senza il permesso necessario falliscono con 403 e
error.type: "authentication_error".
Regole di sicurezza
- Non usare mai le chiavi API in codice browser o mobile. L'API è server-to-server; i browser sono bloccati da CORS per scelta (l'unica origine consentita è il playground di questa documentazione).
- Una chiave per integrazione. Non condividere le chiavi tra sistemi, così puoi rigenerarne una senza rompere le altre.
- Rigenera subito una chiave se viene esposta (dashboard → chiave → Rigenera): il vecchio secret smette di funzionare immediatamente, e ricevi un nuovo secret mostrato una sola volta.
- Le chiavi possono essere revocate in qualsiasi momento; la revoca è immediata.
Ultimo aggiornamento il 20 ottobre 2026