Datakilder og API

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

  1. I venstre sidefelt klikker du på Datakilder, og deretter Ny datakilde.
  2. Under APIvelger du API og klikk på Fortsett.
  3. Velg Hent data fra et API og klikk Fortsett.
  4. Fyll ut Navn på datakilde, Felt for unik identifikator (for eksempel customer_id) og, hvis du ønsker det, Beskrivelse.
  5. Velg metoden: GET eller POST.
  6. Skriv inn API-URL-en din og sett {{uid}} der identifikatoren skal stå, for eksempel https://api.example.com/customers/{{uid}}. Sendtric erstatter {{uid}} med identifikatoren til hver abonnent.
  7. Legg til eventuelle overskrifter API-et ditt trenger, for eksempel Authorization med API-tokenet ditt. Klikk på + Legg til for hver enkelt.
  8. 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 eksempel id = {{uid}}.
  9. Skriv inn en gyldig identifikator i Test verdi for unik identifikator og klikk på Test API.
  10. Kontroller svaret, og klikk deretter på Lagre datakilde.
Innstillingene for «Hent data fra en API» med en URL som inneholder {{uid}}, en autorisasjonsoverskrift, en testverdi og et vellykket test svar

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

Var denne artikkelen nyttig?

Klikk på bildet for å zoome inn. Dra eller rull for å se deg rundt.