Kaarten versturen via een API: zo hebben we die van Yotru opgezet

Met de API van Yotru verstuur je persoonlijke kaarten vanuit je eigen software. Je maakt een kaart, stuurt ontvangers en keurt de campagne goed. Alleen die laatste stap kost geld. Een ontwerp heb je niet nodig: de kaart wordt gebouwd vanaf je website. Hieronder staat waarom we hem zo hebben opgezet.

Waarom een API?

We lanceerden hem in november 2026. De vraag kwam van een klant die kaarten vanuit zijn eigen systeem wilde versturen, zonder elke keer een lijst te exporteren en bij ons te uploaden.

Dat speelt bij meer bedrijven. Een CRM weet wanneer iemand een jaar klant is. Een webshop weet wie al zes maanden niets heeft besteld. Een boekingssysteem weet wie zijn afspraak heeft gemist. Met de API zet zo'n systeem zelf een kaart klaar.

Hoe werkt het in drie calls?

Met GET /v1/cards/{id}/preview/front haal je het plaatje op zoals het gedrukt wordt. Elke kaart krijgt een eigen QR-code, net als bij een bestelling via de site. De volledige beschrijving staat in de documentatie.

Wat krijg je terug?

Je ziet per ontvanger wie de QR-code op zijn kaart scant. Dat staat in je dashboard, en je kunt er meteen een melding van krijgen per mail of in Slack. Een kaart die je software dinsdag klaarzet, kan vrijdag een telefoontje opleveren aan iemand die hem net heeft gelezen.

Gratis bouwen, betalen bij goedkeuren

Een kaart maken, een voorbeeld ophalen en ontvangers toevoegen kost niets. Je betaalt pas als je een campagne goedkeurt. Je kunt de hele koppeling dus bouwen en uitproberen voordat je één euro uitgeeft.

Een aparte testomgeving hoef je niet in te richten. Je werkt vanaf de eerste call met het echte resultaat: het plaatje dat je ophaalt, is hetzelfde plaatje dat naar de drukker gaat.

Wat gebeurt er met een adres dat niet klopt?

Dat ene adres wordt geweigerd en de rest gaat door. Elke ontvanger komt terug als accepted met een id, of als refused met een reden: name, address, country, duplicate of photo. Je systeem weet dus per regel wat er mis is en hoeft niet de hele lijst opnieuw te sturen.

Stuur je dezelfde call per ongeluk twee keer, dan voorkomt een Idempotency-Key in de header dat mensen dubbel op de lijst komen.

Wat kost het?

Hetzelfde als een bestelling via de site. Er is geen minimum: je betaalt voor de kaarten op de campagne. Onder de 100 kaarten geldt per kaart de prijs van 100 stuks. De prijzen staan op de tarievenpagina.

Wat is goed om te weten voordat je bouwt?

• Iemand kijkt mee voor het drukken. Na je goedkeuring loopt bij ons iemand de partij na voordat die naar de drukker gaat. Een fout in duizend gedrukte kaarten haal je niet meer terug.
• Je bouwt met tien templates. Die vul je met je eigen tekst, kleuren, logo en foto.
• De stand haal je op met één call. Een campagne is open, wacht op betaling, is goedgekeurd, ligt bij de drukker of is verstuurd.

Hoe begin je?

Maak een account en open Instellingen, dan API. De eerste sleutel wordt aangemaakt zodra je die pagina opent, en je ziet hem één keer. Je moet eigenaar of beheerder van het account zijn en je e-mailadres bevestigd hebben. Daarna volg je de vier stappen in de documentatie.

Veelgestelde vragen

Kun je de API gratis testen?

Ja. Kaarten maken en ontvangers toevoegen kost niets. Je betaalt pas als je een campagne goedkeurt.

Hoeveel ontvangers kun je per keer sturen?

Tot 1.000 per call. Per sleutel geldt een limiet van 120 calls per minuut.

Kun je een foto per ontvanger meesturen?

Ja, als bestand in dezelfde call. Zonder eigen foto krijgt de ontvanger de foto van de kaart.

Is er een minimum aantal kaarten?

Nee. Onder de 100 kaarten betaal je per kaart de prijs die bij 100 stuks hoort.