Partner-API
Met deze API maak je vanuit je eigen dossier een online rouwkaart bij Rouwkaart Online. Jij kiest het moment en de vormgeving; wij regelen de kaart, de customiser, de bestelling en de mail aan de familie.
Hoe het werkt
De koppeling bestaat uit vijf stappen. Twee daarvan doe jij via de API, de rest gebeurt bij ons.
- Name
1. Thema kiezen- Type
- jouw kant
- Description
Je haalt onze thema's op en toont ze in je eigen vormgeving. Of je slaat deze stap over en laat de familie straks zelf kiezen.
- Name
2. Kaart aanmaken- Type
- jouw kant
- Description
Eén mutatie met de gegevens die je al hebt: naam, geboorte- en overlijdensdatum, portretfoto, contactpersoon. Alles behalve je eigen dossiernummer mag je later aanvullen.
- Name
3. Naar de customiser- Type
- jouw kant
- Description
Bij een klik in jouw dossier vraag je een eenmalige link op en open je die in een nieuwe tab. De familie vult de kaart in op ons domein.
- Name
4. Bestellen en versturen- Type
- onze kant
- Description
De familie bestelt en krijgt van ons een mail met de links naar de kaart en de genodigdenlijst. Daar hoef je niets voor te doen.
- Name
5. Terug in je dossier- Type
- onze kant
- Description
Wij melden elke statuswijziging via een webhook. Zodra de kaart live staat krijg je de openbare link.
Eén endpoint
Alles gaat naar één adres, met één methode. Wat je terugkrijgt bepaal je in de query.
Het enige adres dat je nodig hebt
POST https://memoriam.rouwkaart-online.nl/partner/api/2026-10/graphql
De opzet houdt zich aan wat in GraphQL gebruikelijk is: globale id's, Relay-connecties, mutaties die <resource><Actie> heten en een payload met userErrors teruggeven, en de prijs van je query in extensions.cost.
Deze API is uitsluitend voor server-to-server verkeer. Je sleutel hoort nooit in een browser, een mobiele app of een repository. Daarmee kan iemand kaarten aanmaken op jouw naam. De playground op deze site is de enige plek waar je hem zelf invult, en dan met je testsleutel.
Probeer het meteen
De knop Playground rechtsboven schuift een werkblad open naast de tekst, zoals twee vensters naast elkaar. Je vult er je testsleutel in en voert de query uit die je op dat moment leest: elk GraphQL-voorbeeld op deze site heeft een Probeer dit-knop die hem er met variabelen en al in zet. Je ziet het antwoord, wat het kostte en hoeveel punten je overhoudt.
Wat deze API bewust níét doet
De genodigdenlijst wordt nooit als data gedeeld en nergens ingebed. Wie hem wil zien gaat via een eenmalige link naar onze eigen pagina. Hetzelfde geldt voor de customiser: geen iframe, geen white label. Dat is geen technische beperking maar een keuze: het gaat om de gegevens van een familie op de dag van een afscheid.
Aan de slag
API-sleutel aanvragen
Wat wij van je nodig hebben, wat je terugkrijgt en hoe lang het duurt.
Onderdelen
Thema's
De vormgeving waaruit gekozen kan worden: kleuren, beelden en een voorbeeldkaart om naast de keuze te tonen.
Kaarten
De rouwkaart zelf: aanmaken met de gegevens uit je dossier, bijwerken en de status volgen.
Sessies
Eenmalige links naar de customiser en de genodigdenlijst, tien minuten geldig en één keer bruikbaar.
Webhook-abonnementen
Waar wij je melden dat een kaart is aangemaakt, gewijzigd, besteld of live gegaan.