Komma igång med Klaviyo API
Du kommer att lära dig
Få en grundläggande förståelse för API-anrop och hur Klaviyo API:er kan gynna ditt företag. I den här guiden får du lära dig om REST API:er, HTTP-metoder och utvecklarverktyg för att förbereda dig för att testa Klaviyo API:er. Dina första API-anrop kan du genomföra på så lite som 10 minuter från början till slut. Om du redan är bekant med API-anrop och är redo att testa våra API:er kan du följa vår guide om hur du använder våra Postman-samlingar.
I den här guiden kommer vi att länka till en ordlista när nya tekniska termer introduceras. Om du är osäker på vad ett ord betyder någonstans i guiden kan du kolla in ordlistan för tekniska termer.
Vad är ett REST-API?
REST API är en uppsättning akronymer som står för Representational State Transfer och Application Programming Interface. De här termerna kan enklare förstås som strukturerade förfrågningar som gör att en mjukvara kan prata med en annan och skicka information mellan dem. När du gör ett API-anrop skickar du en begäran till en server där information lagras, som sedan returnerar ett svar med dina begärda data i JSON-, eller JavaScript Object Notation-, format.
Enklare uttryckt gör REST-API:er att du kan begära datalager i Klaviyo och få tillbaka dessa data i ett format som är läsbart för både dig och datorer.
Ett standard-API-anrop sker på några sekunder. I bakgrunden kommer ditt anrop att:
- Skicka en strukturerad begäran om data via internet till API:et. Begäranden skickas via HTTP, en grundläggande typ av nätverksbegäran som stora delar av internet bygger på.
- API:et tar emot begäran, behandlar den och hämtar den begärda informationen från Klaviyos databaser.
- API:et svarar sedan klientapplikationen med JSON-strukturerat format.
- Du får JSON-svaret från ditt klientprogram.
Även om den här kunskapen är till hjälp för att förstå hur dataöverföring fungerar är den inte nödvändig för att börja göra API-anrop och få värde av vad Klaviyos API:er har att erbjuda. Allt du behöver veta för att komma igång med dina första API-anrop tas upp i följande avsnitt.
HTTP-metoder
HTTP-metoder är de ”verb” som används för att skicka dina förfrågningar. Det finns 2 HTTP-metoder som vi kommer att ta upp i den här guiden: GET och POST.
Även om vi inte använder dem här är det värt att notera att de flesta REST-API:er har stöd för ytterligare HTTP-metoder, till exempel PUT, PATCH och DELETE.
HÄMTA
En GET-begäran kan enklast förstås som en ”läs”-begäran. GET-begäranden hämtar information från API- slutpunkten och returnerar den till dig i ett JSON-formaterat svar. Dessa begäranden låter dig bara läsa data, vilket gör dem till den säkraste typen av begäran eftersom dina data inte kan ändras eller skrivas över med den här metoden.
POSTA
En POST-begäran kan enkelt förstås som en ”skriv”-begäran. POST gör att du kan skapa eller lägga till nya resurser. Till exempel kan en POST-begäran till List API användas för att skapa en ny lista i ditt Konto, medan en GET-begäran kan användas för att hämta alla tillgängliga listor. Observera att när du skickar data varierar svaren beroende på när Klaviyo kan slutföra din begäran.
Nödvändiga verktyg
API:er erbjuder stor flexibilitet för dina arbetsflöden och kräver inte att du använder en specifik klientapplikation eller ett språkbibliotek för att uppnå önskade resultat. Eftersom API-anrop görs med HTTP-förfrågningar har nästan alla programmeringsspråk möjlighet att skicka den här typen av förfrågan antingen inbyggt eller via ett språkbibliotek som är allmänt tillgängligt. Dessutom kan du, beroende på din dator och ditt operativsystem, använda inbyggda appar som Apples Terminal eller Windows kommandorad för att göra API-anrop på klientsidan. De här apparna kräver dock förkunskaper om kommandoradsgränssnitt.
Vi använder ett kostnadsfritt webb- och skrivbordsprogram som heter Postman. Postman har en rad funktioner som gör det enklare att konfigurera och skicka en API-begäran genom att ange slutpunkten, parametrar och autentisering i ett användbart användargränssnitt.
Testa Klaviyo API:er
Klaviyos API:er är användbara för att skicka data från andra plattformar eller servrar till Klaviyo-konton eller för att göra frågor om information i ett Klaviyo-konto. Nu när du har förstått hur API:er fungerar kan du börja testa våra API:er för ditt företags användningsfall. För en fullständig lista över Klaviyos tillgängliga API:er kan du läsa vår referensdokumentation för API. Följ vår guide om hur du använder våra Postman-samlingar för att göra ditt första Klaviyo API-anrop.
Ytterligare resurser
Resurser i utvecklarportalen
Klaviyos utvecklarportal innehåller API-guider och referensdokumentation som hjälper dig att få ut mesta möjliga av våra API:er. Ta del av resurserna nedan för att komma igång:
- Klaviyo API-referensdokumentation
- Komma igång med Javascript-API:t
- Konfigurera API-baserade transaktionshändelser
Klaviyo-utvecklarkurser
Klaviyo Academy erbjuder utvecklarkurser som hjälper dig att komma igång med att bygga med Klaviyos API. Kolla in kurserna nedan: