Så här ansluter du en datakälla till ditt eget API
Senast uppdaterad
När en API-datakälla är ansluten anropar Sendtric ditt API för att hämta en prenumerants data när dennes e-postmeddelande öppnas. Ingenting kopieras till Sendtric, så bilderna visar det som ditt API returnerar just i det ögonblicket, till exempel en aktuell orderstatus eller dagens kontosaldo.
Om du hellre vill skicka data till Sendtric i förväg, se hur du skickar poster med Sendtric-API:et.
Vad ditt API behöver
- En HTTPS URL som är tillgänglig från det offentliga internet.
- Ett sätt att hämta en post utifrån dess identifierare, antingen i sökvägen eller i en sökparameter. Till exempel
https://api.example.com/customers/12345. - A JSON svar med postens fält, till exempel
{"first_name": "Sarah", "points": 1250}. - Ett kort svar: Sendtric väntar i upp till 5 sekunder, och svaret måste vara mindre än 1 MB.
Ställ in det
- Klicka i vänster sidofält på Datakälloroch sedan Ny datakälla.
- Under API, välj API och klicka på Fortsätt.
- Välj Hämta data från ett API och klicka på Fortsätt.
- Fyll i Namn på datakälla, Fält för unik identifierare (till exempel
customer_id) och, om du vill, Beskrivning. - Välj metoden: GET eller POST.
- Ange din API-URL och placera
{{uid}}där identifieraren ska stå, till exempelhttps://api.example.com/customers/{{uid}}. Sendtric ersätter{{uid}}med varje abonnents identifierare. - Lägg till valfria rubriker som ditt API behöver, till exempel
Authorizationmed ditt API-token. Klicka på + Lägg till för varje rubrik. - Lägg till valfria frågeparametrar. Om ditt API tar identifieraren som en parameter, ange
{{uid}}in dess värde istället för i URL:en, till exempelid={{uid}}. - Ange ett giltigt identifieringsvärde i Testvärde för unik identifierare och klicka på Testa API.
- Kontrollera svaret och klicka sedan på Spara datakälla.

Spara datakälla förblir inaktiverad tills testet lyckas och svaret innehåller minst ett fält. Om du ändrar URL, metod, rubriker eller parametrar, testa igen.
Använd en test-endpoint eller en särskild, skrivskyddad API-token. Sendtric håller header-värdena hemliga efter att de har sparats, så du måste ange ett nytt värde om du vill ändra det.
Hur uppslag fungerar
- Varje sökning skickar en förfrågan till ditt API för en prenumerant.
- Identifierare skickas exakt så som de fylls i av sammanfogningsetiketten, så det spelar roll om det är stora eller små bokstäver om ditt API tar hänsyn till detta.
- Sendtric sparar en genererad bild för cachtiden som du ställer in i bildredigeraren (2 till 60 minuter), så att upprepade öppningar inte anropar ditt API varje gång.
- Om ditt API är långsamt, returnerar ett fel eller saknar post för identifieraren, betraktas värdet som tomt. I en anpassad bild döljs det lagret, så utforma bilden så att den fortfarande ser bra ut utan det.
Ändra anslutningen
I Datakällorklickar du på datakällan för att öppna dess inställningar. Du kan ändra URL, metod, rubriker och parametrar och sedan köra Testa API igen innan du sparar.
Nästa steg
- Så här använder du en datakälla i en anpassad bild
- Så här använder du en datakälla i en regelbaserad bild
- Vad är datakällor och hur fungerar de?
Var den här artikeln till hjälp?
Tack för din feedback!
