Aan de slag met Klaviyo API's

Wat je leert

Krijg een fundamenteel begrip van API calls en hoe de Klaviyo API je bedrijf van dienst kan zijn.  In deze gids leer je meer over REST API's, HTTP-methodes en ontwikkelaarstools om je voor te bereiden op het testen van de API's van Klaviyo. Je eerste API-aanroepen kunnen van begin tot eind in slechts 10 minuten worden gedaan. Als je al bekend bent met API calls en klaar bent om onze API te testen, volg dan onze gids over het gebruik van onze Postman collecties.

Wat is een REST API?

REST API is een verzameling afkortingen die staan voor Representational State Transfer en Application Programming Interface. Deze termen kunnen eenvoudiger worden opgevat als gestructureerde verzoeken waarmee een stuk software met een ander kan praten en informatie tussen hen kan uitwisselen. Als je een oproep doet op API, dien je een verzoek in bij een server waar informatie wordt opgeslagen, die vervolgens een antwoord terugstuurt met de door jou gevraagde gegevens in JSON-formaat (JavaScript Object Notation).

Eenvoudig gezegd kun je met REST API gegevens opvragen in Klaviyo en die gegevens teruggestuurd krijgen in een formaat dat leesbaar is voor jou en voor computers. 

Een standaard API-aanroep gebeurt in seconden. Achter de schermen zal je gesprek:

1. Stuur een gestructureerd verzoek om gegevens over het internet naar de API. Verzoeken worden verzonden via HTTP, een basistype netwerkverzoek waar het internet grotendeels omheen is gebouwd.
2. De API ontvangt het verzoek, verwerkt het en haalt de gevraagde informatie uit de databases van Klaviyo.
3. De API antwoordt dan aan de clienttoepassing met behulp van het gestructureerde JSON-formaat.
4. Je ontvangt het JSON antwoord van je clientapplicatie.

Hoewel deze kennis nuttig is om te begrijpen hoe gegevensoverdracht werkt, is het niet nodig om te beginnen met API oproepen en waarde te halen uit wat Klaviyo API te bieden heeft. Alles wat je moet weten om aan de slag te gaan met je eerste API-aanroepen wordt behandeld in de volgende secties.

HTTP-methoden

HTTP-methodes zijn de "werkwoorden" waarmee je verzoeken worden verzonden. Er zijn 2 HTTP methodes die we in deze handleiding zullen behandelen: GET en POST.  

OPHALEN

Een GET verzoek kan het gemakkelijkst worden opgevat als een "lees" verzoek. GET verzoeken halen informatie op van het API eindpunt en sturen deze terug in een JSON-geformatteerd antwoord. Met deze verzoeken kun je alleen gegevens lezen, waardoor ze het veiligste type verzoek zijn omdat je gegevens niet kunnen worden gewijzigd of overschreven met deze methode.

POSTEN

Een POST verzoek kan eenvoudig worden opgevat als een "schrijf" verzoek. Met POST kun je nieuwe bronnen maken of toevoegen. Een POST-verzoek naar de lijst API kan bijvoorbeeld worden gebruikt om een nieuwe lijst aan te maken in je account, terwijl een GET-verzoek kan worden gebruikt om alle beschikbare lijsten op te halen. Houd er rekening mee dat bij het plaatsen van gegevens de antwoorden variëren, afhankelijk van wanneer Klaviyo uw verzoek kan voltooien.

Noodzakelijk gereedschap

API's bieden veel flexibiliteit voor je workflow en vereisen niet dat je een specifieke clienttoepassing of taalbibliotheek gebruikt om de gewenste resultaten te bereiken. Omdat API-aanroepen worden gedaan met behulp van HTTP-verzoeken, heeft bijna elke programmeertaal de mogelijkheid om dit soort verzoeken van zichzelf te versturen of via een algemeen beschikbare taalbibliotheek. Daarnaast kun je, afhankelijk van je machine en besturingssysteem, gebruik maken van native applicaties zoals Apple Terminal of Windows Command Line om client-side API-aanroepen te doen. Deze toepassingen vereisen echter voorkennis van commandoregelinterfaces.

We gebruiken een gratis web- en desktopapplicatie genaamd Postman. Postman heeft verschillende functies die het gemakkelijker maken om een API verzoek in te stellen en te versturen door het eindpunt, de parameters en de verificatie in te voeren in een handige gebruikersinterface.

De API's van Klaviyo testen

KlaviyoDe API van Klaviyo is handig voor het verzenden van gegevens van andere platforms of servers naar een Klaviyo account of voor het opvragen van informatie binnen een account. Nu je begrijpt hoe API's werken, kun je beginnen met het testen van onze API's voor de use cases van jouw bedrijf. Voor een volledig overzicht van Klaviyo's beschikbare API, afrekenen onze API referentiedocumentatie. Volg onze gids over hoe je onze Postman collecties kunt gebruiken om je eerste Klaviyo API-aanroep te doen.

Extra hulpbronnen

ontwikkelaarsportaal middelen

KlaviyoHet ontwikkelaarsportaal bevat API gidsen en referentiedocumentatie om je te helpen het meeste uit onze API te halen. afrekenen de bronnen hieronder om aan de slag te gaan:

• Klaviyo API referentiedocumentatie
• Aan de slag met de Javascript API
• API-gebaseerde transactiegebeurtenissen instellen

Klaviyo ontwikkelaar cursus

Klaviyo Academy biedt cursussen voor ontwikkelaars om je op weg te helpen bij het bouwen met Klaviyo API. afrekenen op de onderstaande cursus:

• API grondbeginselen voor marketeers
• Klaviyo ontwikkelaar certificaat
• Algemene API-termen definiëren
• Breng je gegevens in kaart in Klaviyo