Credenziali e ambienti#
Configura le credenziali per il negozio che usa Visualizer SDK e, se necessario, per Product Import API. La lettura della documentazione pubblica non crea credenziali né concede l’accesso a un negozio.
Dove utilizzare ciascuna credenziale?#
| Integrazione | Credenziale | Dove utilizzarla |
|---|---|---|
| SDK del negozio | Shop ID e Publishable Key | Attributi dello script SDK del negozio |
| Product Import API | Client ID e Client Secret | Il tuo sistema lato server o un’attività sicura eseguita sul server |
Publishable Key è destinata al browser. Client Secret deve rimanere sul server. Non incollarli mai in un tema, in Markdown pubblico, in un pacchetto client o in uno screenshot per l’assistenza.
Ottenere e configurare le credenziali#
Apri il pannello di controllo del commerciante, seleziona il negozio corretto e controlla Integrazione SDK e Impostazioni. Segui le istruzioni di configurazione iniziale per Client ID e Client Secret.
Configurare Allowed Origins (CORS)#
Prima di provare o pubblicare SDK, apri Pannello di controllo → Impostazioni per il negozio corretto e individua Allowed Origins (CORS).
- Inserisci le origini dei negozi che caricheranno SDK, separate da virgole. Ad esempio:
https://example.com, https://www.example.com, https://shop.example.com. - Usa protocollo e nome host, più la porta quando necessaria, senza percorso della pagina, stringa di query o frammento. Aggiungi anche l’origine dell’anteprima o dell’ambiente di preproduzione se vi provi SDK; usa
http://localhost:3000soltanto se è l’effettiva origine dell’ambiente di prova locale. - Fai clic su Salva, quindi ricarica il negozio e prova nuovamente SDK.
Controlla l’URL effettivamente visitato dai clienti: https://example.com e https://www.example.com sono origini diverse. Una prova locale o in anteprima riuscita non dimostra che l’origine pubblicata sia configurata.
Sostituire i valori di esempio#
Gli esempi usano segnaposto come <SHOP_ID>, <PUBLISHABLE_KEY> e <YOUR_CLIENT_SECRET>. Sostituiscili solo nell’ambiente previsto. Gli esempi HTML possono codificare le parentesi angolari come < e >; sostituisci l’intero segnaposto, compresa tale codifica.
Ambienti SDK e di importazione prodotti#
Il browser carica https://sdk.ideal.house/sdk.js con Shop ID e Publishable Key dello stesso negozio. Product Import API continua a usare https://sdkapi.ideal.house, con l’autenticazione lato server documentata.
Configura separatamente le origini del negozio in anteprima e in produzione come descritto sopra. Usa prodotti di prova preparati prima di pubblicare, quindi completa la lista di controllo per la pubblicazione.