Iniziare con le API di Klaviyo

Imparerai

Ottenere una comprensione fondamentale delle chiamate API e di come le API di Klaviyo possono essere utili alla sua azienda.  In questa guida, imparerà a conoscere le API REST, i metodi HTTP e gli strumenti per sviluppatori per prepararsi a testare le API di Klaviyo. Le sue prime chiamate API possono essere effettuate in soli 10 minuti dall'inizio alla fine. Se ha già familiarità con le chiamate API ed è pronto a testare le nostre API, segua la nostra guida su come utilizzare le nostre collezioni Postman.

Che cos'è un'API REST?

REST API è un insieme di acronimi che stanno per Representational State Transfer e Application Programming Interface. Questi termini possono essere intesi più semplicemente come richieste strutturate che consentono a un software di parlare con un altro e di passare informazioni tra loro. Quando effettua una chiamata API, invia una richiesta a un server in cui sono memorizzate le informazioni, che poi restituisce una risposta contenente i dati richiesti in formato JSON (JavaScript Object Notation).

Più semplicemente, le API REST le consentono di richiedere i dati archiviati in Klaviyo e di vederseli restituire in un formato leggibile da lei e dai computer. 

Una chiamata API standard avviene in pochi secondi. Dietro le quinte, la sua chiamata sarà:

1. Invia una richiesta strutturata di dati via internet all'API. Le richieste vengono inviate tramite HTTP, un tipo di richiesta di rete di base su cui Internet è ampiamente costruito.
2. L'API riceverà la richiesta, la elaborerà e otterrà le informazioni richieste dai database di Klaviyo.
3. L'API risponde poi all'applicazione client utilizzando il formato strutturato JSON.
4. Riceverà la risposta JSON dalla sua applicazione client.

Anche se questa conoscenza è utile per capire come funziona il trasferimento dei dati, non è necessaria per iniziare a fare chiamate API e ottenere valore dalle API di Klaviyo. Tutto ciò che deve sapere per iniziare a effettuare le prime chiamate API sarà trattato nelle sezioni seguenti.

Metodi HTTP

I Metodi HTTP sono i "verbi" con cui vengono inviate le richieste. Ci sono due metodi HTTP che affronteremo in questa guida: GET e POST.  

GET

Una richiesta GET può essere intesa più facilmente come una richiesta di "lettura". Le richieste GET recuperano informazioni dall'endpoint dell'API e le restituiscono in una risposta formattata in JSON. Queste richieste consentono solo di leggere i dati, il che le rende il tipo di richiesta più sicuro, perché i suoi dati non possono essere modificati o sovrascritti con questo metodo.

POSTA

Una richiesta POST può essere intesa semplicemente come una richiesta di "scrittura". POST le permette di creare o aggiungere nuove risorse. Ad esempio, una richiesta POST all'API List può essere utilizzata per creare un nuovo elenco nel suo account, mentre una richiesta GET può essere utilizzata per recuperare tutti gli elenchi disponibili. Si noti che, quando pubblica i dati, le risposte variano a seconda di quando Klaviyo può completare la sua richiesta.

Strumenti necessari

Le API offrono molta flessibilità ai suoi flussi di lavoro e non richiedono l'utilizzo di un'applicazione client o di una libreria linguistica specifica 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 linguistica ampiamente disponibile. Inoltre, a seconda della macchina e del sistema operativo, può utilizzare applicazioni native come Terminal di Apple o la riga di comando di Windows per effettuare chiamate API lato client. Tuttavia, queste applicazioni richiedono una conoscenza preliminare delle interfacce a riga di comando.

Utilizziamo un'applicazione web e desktop gratuita chiamata Postman.  Postman dispone di una serie di funzioni che rendono più facile l'impostazione e l'invio di una richiesta API, inserendo l'endpoint, i parametri e l'autenticazione in un'utile interfaccia utente.

Testare le API di Klaviyo

Le API di Klaviyo sono utili per inviare dati da altre piattaforme o server agli account Klaviyo o per interrogare le informazioni all'interno di un account Klaviyo. Ora che ha capito come funzionano le API, può iniziare a testare le nostre API per i casi d'uso della sua azienda. Per un elenco completo delle API disponibili di Klaviyo, consulti la nostra documentazione di riferimento sulle API. Segua la nostra guida su come utilizzare le nostre collezioni Postman per effettuare la sua prima chiamata all'API di Klaviyo.

Risorse aggiuntive

Risorse del portale per sviluppatori

Il portale per sviluppatori di Klaviyo contiene guide API e documentazione di riferimento per aiutarla a sfruttare al meglio le nostre API. Consulti le risorse qui sotto per iniziare:

• Documentazione di riferimento dell'API di Klaviyo
• Iniziare con l'API Javascript
• Impostazione di eventi transazionali basati su API

Corsi per sviluppatori di Klaviyo

Klaviyo Academy offre corsi per sviluppatori per aiutarla a iniziare a costruire con le API di Klaviyo. Consulti i corsi qui sotto:

• Certificato di sviluppatore di Klaviyo
• Definire i termini comuni dell'API
• Costruire una conoscenza fondamentale delle API
• Mappa i suoi dati in Klaviyo