Sådan tilslutter du en datakilde til din egen API
Sidst opdateret
Når der er tilknyttet en API-datakilde, kalder Sendtric din API for at hente en abonnents data, når vedkommendes e-mail åbnes. Der kopieres intet over til Sendtric, så billederne viser præcis det, som din API returnerer i det pågældende øjeblik, f.eks. en opdateret ordrestatus eller dagens kontosaldo.
Hvis du hellere vil overføre data til Sendtric på forhånd, kan du læse hvordan du sender poster med Sendtric-API'en.
Hvad dit API har brug for
- En HTTPS URL, der er tilgængelig fra det offentlige internet.
- En måde at hente en enkelt post ved hjælp af dens identifikator, enten i stien eller som en forespørgselsparameter. For eksempel
https://api.example.com/customers/12345. - A JSON -svar med postens felter, såsom
{"first_name": "Sarah", "points": 1250}. - Et kort svar: Sendtric venter op til 5 sekunder, og svaret må ikke være større end 1 MB.
Konfigurer det
- Klik i venstre sidepanel på Datakilder, og derefter Ny datakilde.
- Under APIskal du vælge API og klik på Fortsæt.
- Vælg Hent data fra en API og klik på Fortsæt.
- Udfyld Navn på datakilde, Felt til unik identifikator (for eksempel
customer_id) og, hvis du ønsker det, Beskrivelse. - Vælg metode: GET eller POST.
- Indtast din API-URL, og indsæt
{{uid}}identifikatoren, for eksempelhttps://api.example.com/customers/{{uid}}. Sendtric erstatter{{uid}}med den enkelte abonnents identifikator. - Tilføj eventuelle headere , som din API har brug for, f.eks.
Authorizationmed dit API-token. Klik på + Tilføj for hver enkelt. - Tilføj eventuelle forespørgselsparametre. Hvis din API tager identifikatoren som en parameter, skal du indsætte
{{uid}}dens værdi i stedet for URL'en, for eksempelid={{uid}}. - Indtast en gyldig identifikator i Test værdi for unik identifikator og klik på Test API.
- Kontroller svaret, og klik derefter på Gem datakilde.

Gem datakilde forbliver deaktiveret, indtil testen lykkes, og svaret indeholder mindst ét felt. Hvis du ændrer URL, metode, headere eller parametre, skal du teste igen.
Brug et test-endpoint eller et dedikeret API-token, der kun kan læses. Sendtric holder header-værdierne hemmelige efter gemning, så du skal indtaste en ny, hvis du vil ændre den.
Sådan fungerer opslag
- Hver søgning sender én anmodning til din API for én abonnent.
- Identifikatorer sendes præcis, som de udfyldes af merge-tagget, så der skelnes mellem store og små bogstaver, hvis din API lægger vægt på dette.
- Sendtric gemmer et genereret billede i cache-tiden , du har indstillet i billedredigeringsprogrammet (2 til 60 minutter), så gentagne åbninger ikke kalder din API hver gang.
- Hvis din API er langsom, returnerer en fejl eller ikke har nogen post for identifikatoren, behandles værdien som tom. I et personaliseret billede er dette lag skjult, så sørg for at designe billedet, så det stadig ser godt ud uden det.
Skift forbindelse
I Datakilderskal du klikke på datakilden for at åbne dens indstillinger. Du kan ændre URL'en, metoden, overskrifterne og parametrene og derefter køre Test API igen, før du gemmer.
Næste trin
- Sådan bruges en datakilde i et personligt billede
- Sådan bruges en datakilde i et regelbaseret billede
- Hvad er datakilder, og hvordan fungerer de?
Var denne artikel nyttig?
Tak for din feedback!
