Datakilder og API

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

  1. Klik i venstre sidepanel på Datakilder, og derefter Ny datakilde.
  2. Under APIskal du vælge API og klik på Fortsæt.
  3. Vælg Hent data fra en API og klik på Fortsæt.
  4. Udfyld Navn på datakilde, Felt til unik identifikator (for eksempel customer_id) og, hvis du ønsker det, Beskrivelse.
  5. Vælg metode: GET eller POST.
  6. Indtast din API-URL, og indsæt {{uid}} identifikatoren, for eksempel https://api.example.com/customers/{{uid}}. Sendtric erstatter {{uid}} med den enkelte abonnents identifikator.
  7. Tilføj eventuelle headere , som din API har brug for, f.eks. Authorization med dit API-token. Klik på + Tilføj for hver enkelt.
  8. 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 eksempel id = {{uid}}.
  9. Indtast en gyldig identifikator i Test værdi for unik identifikator og klik på Test API.
  10. Kontroller svaret, og klik derefter på Gem datakilde.
Indstillingerne for »Hent data fra en API« med en URL, der indeholder {{uid}}, en Authorization-header, en testværdi og et vellykket test-svar

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

Var denne artikel nyttig?

Klik på billedet for at zoome ind. Træk eller rul for at se dig omkring.