Een donatie-API voor streamers: bouw je eigen tools met DonoLink

Je standaarddashboard is niet altijd het scherm dat je tijdens een livestream voor je hebt. Misschien werk je met een eigen regie-interface, staat er een kleine monitor naast je camera of bouw je zelf een app voor je stream. Met een donatie-API kun je de activiteit van je kanaal in die omgeving gebruiken. De DonoLink Developer API geeft je daarvoor persoonlijke leestoegang tot donaties en opgeslagen stream-events.

Van je activity feed naar je eigen toepassing

De API brengt twee gegevensbronnen samen: betaalde donaties uit DonoLink, inclusief geïmporteerde historie, en events die DonoLink via je platformkoppelingen heeft opgeslagen. Denk aan follows, subscriptions, gifted subs, cheers en raids. Platformdonaties die al zijn vastgelegd, zoals YouTube Super Chat, kunnen ook in de feed staan. Je hoeft de verschillende bronnen niet ieder in een ander antwoordformaat te verwerken.

Elk event heeft een herkenbaar ID, platform, type, schermnaam, bericht en numerieke waarde met een eenheid. Daarmee kun je bijvoorbeeld donaties op je eigen scherm tonen, een terugblik op een stream maken of een persoonlijke teller voor cadeau-abonnementen bouwen. Controleer altijd de eenheid: TikTok-diamonds zijn geen euro’s, en het aantal kijkers van een raid is geen donatiebedrag.

Drie toepassingen voor streamers en developers

• Een eigen regiescherm. Laat relevante donaties en events naast je camera- en scènebediening zien. Filter op het platform of het eventtype dat op dat moment belangrijk is.
• Een persoonlijke mobiele app. Toon een compacte feed tijdens een IRL-stream. Bewaar je voortgang, zodat je na een verbindingsonderbreking opgeslagen events kunt teruglezen.
• Een overzicht na je stream. Lees een afgebakende periode uit voor je eigen recap. Houd donaties, abonnementen en andere platformwaarden apart in je analyse.

Dit zijn toepassingen die je zelf kunt bouwen. De API levert de gegevens; een complete mobiele app of kant-en-klare externe integratie wordt hiermee niet automatisch geïnstalleerd. Voor een gewone OBS-alert kun je de bestaande DonoLink-overlays blijven gebruiken.

Zo begin je met je eerste API request

1. Maak een DonoLink-account en voltooi je onboarding.
2. Open Instellingen en scroll naar Developer. Maak een API key voor jouw integratie aan.
3. Bewaar de sleutel in de geheime configuratie van je server. Stuur hem als Bearer-token in de Authorization-header.
4. Controleer met GET /api/v1/me welk account bij je sleutel hoort. Lees daarna GET /api/v1/activity.

De API-documentatie bevat een eerste curl-request, een JSON-voorbeeld en een downloadbare OpenAPI-specificatie. Je kunt maximaal 100 events per pagina lezen. Via de cursor vraag je volgende pagina’s op, zonder een vaste limiet op het aantal historische pagina’s. De accountlimiet is 120 requests per 60 seconden, gedeeld door alle sleutels.

Een persoonlijke sleutel met beperkte rechten

Een sleutel geeft toegang tot jouw eigen account en heeft alleen de scope activity:read. Er zijn geen rechten om donaties te wijzigen, je instellingen aan te passen of geld uit te betalen. DonoLink slaat een hash van de sleutel op. De volledige sleutel kun je alleen direct na aanmaken zien; later trek je hem in of maak je een vervanger aan.

Die beperkte rechten maken een sleutel nog steeds vertrouwelijk: schermnamen en donatieberichten kunnen persoonsgegevens bevatten. Zet hem niet in je openbare websitecode, Git-repository of streambeeld. Voor een persoonlijke native app gebruik je beveiligde opslag. Voor een applicatie met meerdere gebruikers scheid je de geheimen per account. Een OAuth-koppeling voor zulke apps is in v1 nog niet beschikbaar.

Wat je vooraf over historie moet weten

De API leest wat DonoLink daadwerkelijk heeft opgeslagen. Een nieuwe platformkoppeling haalt niet automatisch alle oude follows of subscriptions bij Twitch, YouTube, Kick of TikTok op. Geïmporteerde donaties zijn herkenbaar aan hun importbron. Volledig terugbetaalde of betwiste donaties en testalerts ontbreken in de feed. Gebruik hem daarom voor activiteit, niet als bankafschrift of boekhouding.

Wil je tijdens je stream blijven bijwerken? Lees de handleiding voor een activity feed in je IRL-app. Daar staat hoe je polling, historische pagina’s en herstel na netwerkverlies combineert. In de referentie voor historie en live feed vind je het bijbehorende codevoorbeeld.