Come impostare, utilizzare e risolvere i problemi delle API key per collegare le integrazioni al tuo sito.

Un'interfaccia di programmazione delle applicazioni (API) consente agli sviluppatori di creare integrazioni e applicazioni che possono essere collegate al tuo sito Squarespace.

Questa guida offre una panoramica generale dell'API Squarespace e delle API key univoche. Per informazioni dettagliate, visita la documentazione per gli sviluppatori API.

Per ricevere assistenza con Zapier, visita Aggiunta di integrazioni di moduli con Zapier.

L'API Squarespace è una funzionalità Premium:

• Forms API (per l'integrazione con Zapier) è disponibile nei piani Business, Commerce, Professional e Premium.
• Orders API è disponibile nei piani Commerce Avanzato e Premium.
• Inventory API è disponibile nei piani Commerce Avanzato e Premium.
• Transactions API è disponibile nei piani Commerce Avanzato e Premium.

Informazioni sulle nostre API

Cosa puoi costruire

Con la nostra API, è possibile creare integrazioni dirette con altri software, con un'ampia varietà di casi d'uso. Crea un'API key Moduli per utilizzare la nostra integrazione con Zapier o crea API key Commerce per realizzare i tuoi strumenti di Commerce personalizzati.

Utilizzando i dati a cui forniamo accesso tramite la nostra API, è possibile:

• Connettersi ad applicazioni di gestione ordini o di spedizione di terze parti
• Sincronizzare l'inventario con altri canali di vendita o con dei sistemi gestionali
• Invia e-mail di conferma degli ordini tramite software di terze parti
• Automatizzare la stampa di etichette
• Automatizzare la contabilità
• Connettersi alla nostra integrazione con Zapier

Per verificare se un'integrazione è possibile, consulta la nostra documentazione per sviluppatori.

Sicurezza delle chiavi API

La chiave univoca API è una stringa casuale di caratteri che consente l'accesso autenticato all'account Squarespace.

Per creare una nuova chiave:

1. Apri il pannello Strumenti per sviluppatori.
2. Clicca su Chiavi API per sviluppatore.
3. Clicca su Genera chiave.
   
4. Immettere un nome della chiave.
5. Alla voce Autorizzazioni, seleziona Ordini, Moduli, Inventario o Transazioni. I moduli sono disponibili dal piano Business in su, mentre Ordini, Inventario e Transazioni sono disponibili solo nei piani Commerce Avanzato e Premium.
6. Seleziona le autorizzazioni per la API key.
7. Clicca su Avanti.
8. Copia la tua chiave API univoca.

Una volta ottenuta la chiave:

• Conservala in modo sicuro. Tratta la tua chiave API con la stessa cura con cui tratteresti la password di un account.
• Copiala e salvala nella tua memoria. Per motivi di sicurezza, non memorizziamo la tua chiave API. Una volta chiusa la finestra è impossibile recuperarla, ma se dovessi perderla, puoi sempre crearne una nuova.

Puoi seguire di nuovo questi passaggi per creare ulteriori chiavi.

Integrazione con Zapier

È possibile collegare i blocchi Moduli, Newsletter e Copertine allo strumento di automazione online Zapier. In questo modo è possibile creare Zaps, un tipo di flusso di lavoro automatizzato, che usa invii di moduli per attivare ulteriori integrazioni Zapier come Slack, Trello, ConvertKit, Salesforce e altro ancora. Questo strumento può aiutare a risparmiare tempo collegando Squarespace a strumenti utili e a processi automatizzati.

Per assistenza, visita Aggiungere integrazioni di moduli con Zapier.

API Commerce

Utilizza le API Commerce per sincronizzare con servizi di terze parti i dati degli ordinativi, dell'inventario e delle transazioni del tuo negozio. Si tratta di un modo eccellente per collegare il tuo negozio Squarespace con altri servizi che usi per gestire la tua attività, e per automatizzare compiti fondamentali come le spedizioni o il saldo fiscale. Scopri come usare queste API nella documentazioni dedicata agli sviluppatori:

• API Inventario - Sincronizza il tuo inventario Squarespace con i sistemi di gestione del magazzino.
• API Ordini - Sincronizza gli ordini Squarespace con i servizi di spedizione e gestione. È inoltre possibile utilizzare l'API Scrittura Ordini per importare ordini da canali di vendita terzi.
• API Prodotti - Crea, modifica e rimuovi prodotti.
• API Transazioni - Sincronizza le transazioni e le donazioni su Squarespace con i servizi di contabilità.
• API di sottoscrizioni Webhook - Iscriviti alle notifiche dai siti Squarespace.

Ricorda:

• Non è possibile utilizzare l'API Commerce per connettere un elaboratore di pagamento di terze parti. Puoi utilizzare Square per punto vendita, Stripe o PayPal solo per elaborare gli ordini effettuati sul tuo sito.
• Le API Ordini e Inventario sono progettate per consentire agli operatori commerciali di creare le proprie integrazioni personalizzate. Puoi trovare le estensioni ufficiali create da servizi di terze parti su Squarespace Extensions.

Revoca di una chiave API

Per revocare una chiave API, eliminarla nel pannello Chiavi API di Squarespace:

1. Apri il pannello Strumenti per sviluppatori.
2. Clicca su Chiavi API per sviluppatore.
3. Fai clic sull'icona del cestino accanto alla chiave API che desideri revocare.
4. Clicca su Conferma.

L'eliminazione di una chiave API interrompe la connessione tra il sito e l'app o il servizio che stanno utilizzando la chiave per accedere ai dati del sito. L'app o il servizio potrebbero ancora contenere dati che hai inviato mentre l'API era connessa. Contatta direttamente lo sviluppatore per gestire i tuoi dati storici.

Risoluzione dei problemi e assistenza

Chiavi di accesso API

Consigliamo di cominciare con questi step per la risoluzione di problemi relativi alle API key:

• Assicurati di utilizzare il giusto tipo di chiave API. Ad esempio, puoi utilizzare solo le API dei moduli per creare integrazioni di moduli.
• Se un particolare modulo o ordine non viene visualizzato, assicurati di aver creato la chiave API per il sito corretto.
• Se un modulo non viene visualizzato in Zapier e la chiave API è per il sito corretto, elimina il modulo su Squarespace e aggiungine uno nuovo.

API Commerce

Per assistenza nell'utilizzo delle API Commerce di Squarespace, visita il nostro sito per sviluppatori, che contiene una documentazione dettagliata su tutte le nostre API pubbliche. In caso di ulteriori domande, contattaci.