Snel starten

Je hebt een testsleutel. In vier verzoeken sta je met een kaart in de customiser. Elk voorbeeld hieronder is een compleet commando: vervang {access_token} door je sleutel en het draait. De teststand maakt geen echte kaarten aan en stuurt geen post naar een familie.

Liever zonder terminal? De knop Playground rechtsboven schuift een werkblad open naast de tekst. Je vult er je testsleutel in en voert de query uit die je aan het lezen bent: elk GraphQL-voorbeeld heeft een Probeer dit-knop die hem er met variabelen en al in zet.

Werkt er iets niet, kijk dan eerst naar het antwoord zelf. Een 401 betekent dat de sleutel niet klopt; een fout in wat je vroeg staat in userErrors en wijst het veld aan. Zie Fouten.

Stap 1. Haal de thema's op

Een thema bepaalt de sfeer van de kaart. Je toont ze in je eigen vormgeving en onthoudt het id dat de familie kiest.

demoUrl wijst naar een ingerichte voorbeeldkaart in dat thema. Zet die ernaast, dan ziet iemand waar hij ja tegen zegt.

Vraag alleen de velden op die je gebruikt: wat je niet opvraagt, halen wij ook niet op.

Verzoek

QUERY

themes

query Themes {
  themes(first: 10) {
    edges {
      node {
        id
        title
        description
        demoUrl
        images { url altText }
      }
    }
  }
}

Antwoord

{
  "data": {
    "themes": {
      "edges": [
        {
          "node": {
            "id": "gid://rouwkaart/Theme/15367310377305",
            "title": "Bloemen",
            "description": "Getekende bloemen in aquarel.",
            "demoUrl": "https://memoriam.rouwkaart-online.nl/memoriam/elena-van-vliet-1938-03-14",
            "images": [
              {
                "url": "https://cdn.shopify.com/s/files/1/bloemen.png",
                "altText": "Thema Bloemen"
              }
            ]
          }
        }
      ]
    }
  },
  "extensions": {
    "cost": {
      "requestedQueryCost": 42,
      "actualQueryCost": 6,
      "throttleStatus": {
        "maximumAvailable": 1000,
        "currentlyAvailable": 994,
        "restoreRate": 50
      }
    }
  }
}

Stap 2. Maak een kaart

Alleen externalDossierId is verplicht: jouw eigen dossiernummer, uniek binnen je account. Al het andere mag je later aanvullen.

themeId mag je weglaten. De customiser opent dan met een korte wizard waarin de familie zelf het thema, de opzet van de kaart en de zichtbaarheid kiest. Kies je liever vooraf in je eigen vormgeving, stuur dan het id uit stap 1 mee.

De portretfoto halen wij op en slaan wij zelf op, zodat de kaart blijft werken los van jouw systeem en jouw server geen bezoekersverkeer krijgt.

Bewaar card.id, want daar draait de rest van de koppeling om.

Verzoek

MUTATION

cardCreate

mutation CreateCard($input: CardCreateInput!) {
  cardCreate(input: $input) {
    card {
      id
      status
    }
    userErrors {
      field
      message
      code
    }
  }
}

Antwoord

{
  "data": {
    "cardCreate": {
      "card": {
        "id": "gid://rouwkaart/Card/069a4543-62ed-442a-b69f-489b3182431a",
        "status": "DRAFT"
      },
      "userErrors": []
    }
  }
}

Stap 3. Stuur de familie naar de customiser

Vraag deze link aan op het moment dat iemand in jouw dossier op de knop klikt, en open hem in een nieuwe tab.

Sla deze URL nergens op. Hij is tien minuten geldig en werkt precies één keer. Zet hem niet in een mail, een logregel of een href die vooraf geladen kan worden, want dan is hij op voordat iemand klikt.

Bij het openen wisselen wij het token in voor een sessie op ons domein en verdwijnt het uit de adresbalk. Die sessie opent deze ene kaart en dit ene onderdeel, verder niets.

Verzoek

MUTATION

cardSessionCreate

mutation CreateCardSession($cardId: ID!) {
  cardSessionCreate(cardId: $cardId, target: CUSTOMIZER) {
    cardSession {
      url
      expiresAt
    }
    userErrors {
      message
    }
  }
}

Antwoord

{
  "data": {
    "cardSessionCreate": {
      "cardSession": {
        "url": "https://memoriam.rouwkaart-online.nl/partner/toegang/h7k2p9qm4xab3cde5fgh7jkm9npq2rst",
        "expiresAt": "2026-09-25T12:10:00.000Z"
      },
      "userErrors": []
    }
  }
}

Stap 4. Volg de status

Zolang de familie bezig is blijft de kaart DRAFT. Na het bestellen wordt hij ORDERED en zodra de openbare pagina online staat ACTIVE. Dan is ook cardUrl gevuld.

In productie hoef je hier niet op te pollen: webhooks melden elke wijziging. Tijdens het bouwen is dit wel de handigste manier om te kijken waar je staat.

theme wordt alleen opgehaald wanneer je ernaar vraagt. Laat je het weg, dan doen wij ook geen verzoek aan onze productcatalogus.

Verzoek

QUERY

card

query Card($id: ID!) {
  card(id: $id) {
    status
    cardUrl
    updatedAt
    theme {
      title
    }
  }
}

Antwoord

{
  "data": {
    "card": {
      "status": "ACTIVE",
      "cardUrl": "https://memoriam.rouwkaart-online.nl/memoriam/jan-jansen-1940-05-01",
      "updatedAt": "2026-09-26T09:14:03.000Z",
      "theme": { "title": "Bloemen" }
    }
  }
}

Wat je in je dossier laat zien

Drie dingen, en dat is genoeg:

Name
Rouwkaart bewerken
Type
altijd
Description
Een knop die bij een klik een verse sessie met target: CUSTOMIZER opvraagt en de URL in een nieuwe tab opent.
Name
Genodigden bekijken
Type
altijd
Description
Dezelfde knop met target: INVITEE_LIST.
Name
Bekijk de kaart
Type
zodra status ACTIVE is
Description
Gewoon een link naar cardUrl. Die mag je wél opslaan; hij is openbaar en blijft werken.

Verder

Alles over kaarten Webhooks instellen Testen