Gegevensbronnen & API

Hoe sluit je een gegevensbron aan op je eigen API?

Laatst bijgewerkt

Als er een API-gegevensbron is gekoppeld, roept Sendtric je API op om de gegevens van een abonnee op te halen zodra zijn of haar e-mail wordt geopend. Er wordt niets naar Sendtric gekopieerd, dus afbeeldingen tonen precies wat je API op dat moment teruggeeft, zoals de actuele bestelstatus of het saldo van vandaag.

Als je de gegevens liever van tevoren naar Sendtric wilt sturen, kijk dan hoe je records kunt versturen met de Sendtric API.

Wat je API nodig heeft

  • Een HTTPS URL die bereikbaar is via het openbare internet.
  • Een manier om één record op te vragen aan de hand van de identificatiecode, in het pad of via een queryparameter. Bijvoorbeeld https://api.example.com/customers/12345.
  • A JSON antwoord met de velden van het record, zoals {"first_name": "Sarah", "points": 1250}.
  • Een kort antwoord: Sendtric wacht maximaal 5 seconden, en het antwoord moet kleiner zijn dan 1 MB.

Stel het in

  1. Klik in de linkerzijbalk op Gegevensbronnenen vervolgens Nieuwe gegevensbron.
  2. Onder APIkies je API en klik op Doorgaan.
  3. Kies Gegevens ophalen via een API en klik op Doorgaan.
  4. Vul in Naam van de gegevensbron, Veld voor unieke identificatie (bijvoorbeeld customer_id) en, als je wilt, Beschrijving.
  5. Kies de methode: GET of POST.
  6. Voer je API-URL in en zet {{uid}} de identificatiecode in, bijvoorbeeld https://api.example.com/customers/{{uid}}. Sendtric vervangt {{uid}} door de identificatiecode van elke abonnee.
  7. Voeg eventuele headers die je API nodig heeft, zoals Authorization met je API-token. Klik op op + Toevoegen voor elke header.
  8. Voeg eventuele queryparameters. Als je API de identificatiecode als parameter gebruikt, zet dan {{uid}} de waarde ervan in plaats van de URL, bijvoorbeeld id = {{uid}}.
  9. Voer een echte identificatiecode in Test waarde unieke identificatiecode en klik op API testen.
  10. Bekijk het antwoord en klik vervolgens op Gegevensbron opslaan.
De instellingen voor ‘Gegevens ophalen uit een API’ met een URL die {{uid}} bevat, een Authorization-header, een testwaarde en een succesvol testantwoord

Gegevensbron opslaan blijft uitgeschakeld totdat de test slaagt en het antwoord minstens één veld bevat. Als je de URL, methode, headers of parameters wijzigt, test dan opnieuw.

Gebruik een test-endpoint of een speciaal, alleen-lezen API-token. Sendtric houdt headerwaarden geheim nadat ze zijn opgeslagen, dus je moet er een opnieuw invoeren om deze te wijzigen.

Hoe zoekopdrachten werken

  • Bij elke zoekopdracht wordt één verzoek naar je API gestuurd voor één abonnee.
  • Identificatiegegevens worden precies zo verzonden als de merge-tag ze invult, dus het maakt wel degelijk uit of je hoofdletters of kleine letters gebruikt als je API daar op let.
  • Sendtric bewaart een gegenereerde afbeelding voor de cachetijd die je in de afbeeldingseditor hebt ingesteld (2 tot 60 minuten), zodat je API niet elke keer wordt aangeroepen als de afbeelding opnieuw wordt geopend.
  • Als je API traag is, een foutmelding geeft of geen gegevens voor de identificatiecode heeft, wordt de waarde als leeg beschouwd. In een gepersonaliseerde afbeelding wordt die laag verborgen, dus zorg ervoor dat de afbeelding er ook zonder die laag nog goed uitziet.

De verbinding wijzigen

In Gegevensbronnenklik je op de gegevensbron om de instellingen te openen. Je kunt de URL, methode, headers en parameters aanpassen en vervolgens de API-test opnieuw uitvoeren voordat je opslaat.

Volgende stap

Was dit artikel nuttig?

Klik op de afbeelding om in te zoomen. Sleep of scrol om rond te kijken.