Primi passi con le API di Klaviyo
Cosa imparerai
Ottieni una comprensione di base delle chiamate API e di come le API di Klaviyo possono essere utili per la tua attività. In questa guida scoprirai le API REST, i metodi HTTP e gli strumenti per sviluppatori per prepararti a testare le API di Klaviyo. Le tue prime chiamate API possono essere completate in soli 10 minuti dall’inizio alla fine. Se conosci già le chiamate API e sei pronto a testare le nostre API, segui la nostra guida su come usare le nostre raccolte Postman.
In questa guida, inseriremo link a un glossario quando vengono introdotti nuovi termini tecnici. Se in qualsiasi momento della guida non sei sicuro del significato di una parola, consulta il glossario dei termini tecnici.
Che cos’è un’API REST?
REST API è un insieme di acronimi che sta per Representational State Transfer e Application Programming Interface. Questi termini possono essere compresi più semplicemente come richieste strutturate che permettono a un software di comunicare con un altro e di trasferire informazioni tra i due. Quando effettui una chiamata API, invii una richiesta a un server in cui sono archiviate informazioni, che poi restituisce una risposta contenente i dati richiesti in formato JSON, ovvero JavaScript Object Notation.
In modo più semplice, le API REST ti consentono di richiedere i dati archiviati in Klaviyo e di riceverli in un formato leggibile sia da te sia dai computer.
Una chiamata API standard avviene in pochi secondi. Dietro le quinte, la tua chiamata:
- Invia una richiesta di dati strutturata tramite internet all’API. Le richieste vengono inviate tramite HTTP, un tipo di richiesta di rete di base su cui si basa in gran parte internet.
- L'API riceverà la richiesta, la elaborerà e otterrà le informazioni richieste dai database di Klaviyo.
- L’API risponde quindi all’applicazione client utilizzando il formato strutturato JSON.
- Riceverai la risposta JSON dalla tua applicazione client.
Anche se queste informazioni sono utili per capire come funziona il trasferimento dei dati, non sono necessarie per iniziare a effettuare chiamate API e ottenere valore da ciò che le API di Klaviyo hanno da offrire. Tutto ciò che devi sapere per iniziare con le tue prime chiamate API verrà trattato nelle sezioni seguenti.
Metodi HTTP
I metodi HTTP sono i “verbi” con cui vengono inviate le tue richieste. In questa guida tratteremo 2 metodi HTTP: GET e POST.
Anche se qui non li useremo, vale la pena notare che la maggior parte delle API REST supporta metodi HTTP aggiuntivi come PUT, PATCH e DELETE.
OTTIENI
Una richiesta GET può essere compresa più facilmente come una richiesta di "lettura". Le richieste GET recuperano informazioni dall'endpoint API e te le restituiscono in una risposta JSON formattata. Queste richieste ti consentono solo di leggere i dati, quindi sono il tipo di richiesta più sicuro perché con questo metodo i dati non possono essere modificati o sovrascritti.
PUBBLICA
Una richiesta POST può essere compresa semplicemente come una richiesta di "scrittura". POST ti consente di creare o aggiungere nuove risorse. Ad esempio, una richiesta POST all'API Elenchi può essere utilizzata per creare un nuovo elenco nel tuo account, mentre una richiesta GET può essere utilizzata per recuperare tutti gli elenchi disponibili. Nota che, quando pubblichi dati, le risposte varieranno in base a quando Klaviyo potrà completare la tua richiesta.
Strumenti necessari
Le API offrono molta flessibilità al tuo flusso di lavoro e non richiedono l’uso di un’applicazione client specifica o di una libreria di linguaggio per ottenere i risultati desiderati. Poiché le chiamate API vengono effettuate tramite richieste HTTP, quasi tutti i linguaggi di programmazione hanno la possibilità di inviare questo tipo di richiesta in modo nativo o tramite una libreria di linguaggio ampiamente disponibile. Inoltre, in base al tuo computer e al sistema operativo, puoi usare applicazioni native come Terminale di Apple o Riga di comando di Windows per effettuare chiamate API lato client. Tuttavia, queste applicazioni richiedono una conoscenza pregressa delle interfacce a riga di comando.
Usiamo un'applicazione web e desktop gratuita chiamata Postman. Postman offre una varietà di funzionalità che rendono più semplice configurare e inviare una richiesta API inserendo endpoint, parametri e autenticazione in un'interfaccia utente utile.
Testa le API di Klaviyo
Le API di Klaviyo sono utili per inviare dati da altre piattaforme o server agli account Klaviyo o per interrogare informazioni all'interno di un account Klaviyo. Ora che hai capito come funzionano le API, puoi iniziare a testare le nostre API per i casi d'uso della tua azienda. Per un elenco completo delle API disponibili di Klaviyo, consulta la nostra documentazione di riferimento delle API. Segui la nostra guida su come usare le nostre raccolte Postman per effettuare la tua prima chiamata API di Klaviyo.
Risorse aggiuntive
Risorse del portale di sviluppo
Il portale di sviluppo di Klaviyo contiene guide alle API e documentazione di riferimento per aiutarti a sfruttare al massimo le nostre API. Esplora le risorse qui sotto per muovere i primi passi:
- Documentazione di riferimento per le API di Klaviyo
- Primi passi con l'API Javascript
- Configurazione di eventi transazionali basati su API
Corsi Klaviyo Developers
Klaviyo Academy offre corsi per sviluppatori per aiutarti a iniziare a creare con le API di Klaviyo. Dai un'occhiata ai corsi sotto: