Slik kobler du en datakilde til din egen API
Sist oppdatert
Når en API-datakilde er tilkoblet, sender Sendtric en forespørsel til API-et ditt for å hente abonnentens data når e-posten åpnes. Ingenting kopieres inn i Sendtric, så bildene viser akkurat det API-et ditt returnerer i det øyeblikket, for eksempel en oppdatert ordrestatus eller dagens kontosaldo.
Hvis du heller vil overføre data til Sendtric på forhånd, kan du se hvordan du sender poster med Sendtric-API-et.
Hva API-et ditt trenger
- En HTTPS URL som er tilgjengelig fra det offentlige internett.
- En måte å hente én post ved hjelp av identifikatoren, enten i banen eller i en spørringsparameter. For eksempel
https://api.example.com/customers/12345. - A JSON -svar med postens felt, for eksempel
{"first_name": "Sarah", "points": 1250}. - Et kort svar: Sendtric venter i opptil 5 sekunder, og svaret må være under 1 MB.
Sett det opp
- I venstre sidefelt klikker du på Datakilder, og deretter Ny datakilde.
- Under APIvelger du API og klikk på Fortsett.
- Velg Hent data fra et API og klikk Fortsett.
- Fyll ut Navn på datakilde, Felt for unik identifikator (for eksempel
customer_id) og, hvis du ønsker det, Beskrivelse. - Velg metoden: GET eller POST.
- Skriv inn API-URL-en din og sett
{{uid}}der identifikatoren skal stå, for eksempelhttps://api.example.com/customers/{{uid}}. Sendtric erstatter{{uid}}med identifikatoren til hver abonnent. - Legg til eventuelle overskrifter API-et ditt trenger, for eksempel
Authorizationmed API-tokenet ditt. Klikk på + Legg til for hver enkelt. - Legg til eventuelle spørringsparametere. Hvis API-et ditt tar identifikatoren som en parameter, sett
{{uid}}denne verdien i stedet for i URL-en, for eksempelid={{uid}}. - Skriv inn en gyldig identifikator i Test verdi for unik identifikator og klikk på Test API.
- Kontroller svaret, og klikk deretter på Lagre datakilde.

Lagre datakilde forblir deaktivert inntil testen lykkes og svaret inneholder minst ett felt. Hvis du endrer URL, metode, overskrifter eller parametere, må du teste på nytt.
Bruk et test-endepunkt eller et eget, skrivebeskyttet API-token. Sendtric holder header-verdiene hemmelige etter at de er lagret, så du må oppgi en ny verdi for å endre den.
Slik fungerer oppslag
- Hver oppslagssøk sender én forespørsel til API-et ditt for én abonnent.
- Identifikatorene sendes nøyaktig slik de fylles ut av sammenslåingsmerket, så det spiller en rolle om det brukes store eller små bokstaver dersom API-et ditt tar hensyn til dette.
- Sendtric lagrer et generert bilde for Cache-tiden du angir i bildeditoren (2 til 60 minutter), slik at gjentatte åpninger ikke utløser API-anrop hver gang.
- Hvis API-et ditt er tregt, returnerer en feilmelding eller ikke har noen oppføring for identifikatoren, blir verdien behandlet som tom. I et personalisert bilde er dette laget skjult, så utform bildet slik at det fremdeles ser bra ut uten det.
Endre tilkoblingen
I Datakilderklikker du på datakilden for å åpne innstillingene. Du kan endre URL, metode, overskrifter og parametere, og deretter kjøre Test API på nytt før du lagrer.
Neste trinn
- Slik bruker du en datakilde i et personalisert bilde
- Slik bruker du en datakilde i et regelbasert bilde
- Hva er datakilder, og hvordan fungerer de?
Var denne artikkelen nyttig?
Takk for tilbakemeldingen din!
