Développez vos outils de streaming

Démarrage rapide

Utilisez l’API depuis votre serveur ou application personnelle. Les endpoints utilisent JSON et nécessitent les autorisations appropriées. L’activité est en lecture seule ; les paramètres du bot peuvent être modifiés avec bot:write. L’URL de base est https://donolink.nl/api/v1.

1. Accédez à Paramètres → Développeur → Clés API. Nommez votre intégration et choisissez une date d'expiration.
2. Copiez la clé une fois et stockez-la sous DONOLINK_API_KEY dans la configuration secrète de votre serveur.
3. Faites votre première demande. Sans filtres, vous recevez jusqu'à 50 événements, le plus récent en premier.

curl 'https://donolink.nl/api/v1/activity?limit=50' \
  -H "Authorization: Bearer $DONOLINK_API_KEY"

Exemple de réponse

{
  "data": [
    {
      "id": "evt_abcdefghijklmno",
      "type": "subscription",
      "platform": "twitch",
      "occurred_at": "2026-09-07T12:00:00.000Z",
      "recorded_at": "2026-09-07T12:00:00.000Z",
      "actor": {
        "name": "StreamFan"
      },
      "message": null,
      "value": 3,
      "unit": "months",
      "currency": null,
      "refunded_amount_cents": null
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": "OPAQUE_CURSOR"
  }
}

Authentification

Envoyez votre clé dans l’en-tête Authorization à chaque requête. Un cookie de session, un paramètre de requête ou un jeton d’overlay ne donne pas accès à cette API.

Authorization: Bearer dl_live_YOUR_SECRET_KEY

Choisissez une validité de 30, 90 ou 365 jours. Vous pouvez avoir jusqu'à 10 clés actives et créer une clé par minute. DonoLink stocke uniquement un hachage SHA-256 ; la clé complète n'est visible qu'immédiatement après la création.

Utilisez une clé distincte par intégration. Pour effectuer une rotation, créez une nouvelle clé, mettez à jour votre application, puis révoquez l'ancienne. Une clé révoquée ou expirée cesse de fonctionner à la demande suivante.

Choisissez activity:read, bot:read et/ou bot:write à la création de la clé. Ces autorisations sont indépendantes ; les anciennes clés conservent uniquement activity:read. La clé est liée à votre compte sans droits de paiement ou d’administration de la plateforme. OAuth multi-clients n’est pas encore disponible.

Points de terminaison

Vérifiez à quel streamer appartient votre clé et quand elle expire. Seuls le profil public, la portée et les métadonnées clés sont renvoyés.

{
  "data": {
    "id": "abcdefghijklmno",
    "username": "streamer",
    "display_name": "Streamer",
    "scopes": [
      "activity:read"
    ],
    "key": {
      "prefix": "dl_live_123456789",
      "expires_at": "2026-12-06 12:00:00.000Z"
    }
  }
}

Lisez le flux combiné des dons DonoLink et des événements de plateforme stockés. Le compte est déterminé exclusivement à partir de la clé API.

Les paramètres inconnus ou répétés renvoient HTTP 400. Ne mettez pas d'ID de compte, de clé ou de filtre PocketBase dans l'URL.

Nécessite bot:read. Renvoie data contenant revision et config pour votre bot. Aucun paramètre de requête. La configuration comprend commandes, minuteries, filtres, habitués et commandes intégrées. Traitez les modèles de réponse comme des données confidentielles.

Nécessite bot:write. Envoyez la config complète et la dernière revision lue dans un objet JSON. Le succès renvoie data avec la nouvelle revision et config. Sur 409 revision_conflict, relisez et intégrez les changements récents avant d’enregistrer. N’envoyez pas d’identifiant propriétaire ; la clé détermine le compte.

{
  "revision": 7,
  "config": {
    "version": 1,
    "enabled": true,
    "commands": [
      {
        "id": "cmd_socials",
        "name": "!socials",
        "message": "Follow the stream at {channel}!",
        "enabled": true,
        "role": "everyone",
        "cooldownSeconds": 30,
        "alias": ""
      }
    ],
    "timers": [],
    "filters": {
      "words": {
        "enabled": true,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 1,
        "minLength": 0
      },
      "caps": {
        "enabled": false,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 50,
        "minLength": 10
      },
      "emotes": {
        "enabled": false,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 20,
        "minLength": 10
      },
      "links": {
        "enabled": true,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 1,
        "minLength": 10
      },
      "symbols": {
        "enabled": false,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 30,
        "minLength": 10
      },
      "repetitions": {
        "enabled": false,
        "exemptRole": "moderator",
        "timeoutSeconds": 600,
        "silent": false,
        "message": "",
        "threshold": 10,
        "minLength": 10
      }
    },
    "blockedWords": [
      "exampleword"
    ],
    "allowedHosts": [
      "youtube.com"
    ]
  }
}

Utilisez application/json et UTF-8, au maximum 2 000 000 octets en dix secondes. Une config invalide renvoie 422 ; une autorisation manquante renvoie 403. OpenAPI précise les champs et limites. Après une écriture incertaine, relisez et comparez ; n’écrasez jamais aveuglément une révision plus récente.

GET nécessite bot:read et renvoie data avec revision et state : file, playlist, paramètres et état de lecture. POST nécessite bot:write : envoyez operationKey (16 à 100 lettres/chiffres/_/-), revision et action. Actions : request/playlist-add avec query, settings, playlist-remove, remove, promote, move (positions à partir de 1), volume, seek, play, pause, skip et clear. Consultez OpenAPI pour les champs. Après une réponse incertaine, répétez exactement le même corps ; l’action s’applique une seule fois. Sur music_revision_conflict, relisez et fusionnez ; utilisez une nouvelle operationKey pour une action modifiée. Maximum 16 000 octets en 10 secondes ; aucun paramètre de requête ni propriétaire. La lecture nécessite un lecteur actif dans le tableau de bord. La recherche YouTube exige une configuration serveur ; la recherche SoundCloud exige un identifiant client et un secret sur le serveur.

{
  "operationKey": "42eed350-2ab8-46ea-8ae4-c02dfe296f9e",
  "revision": 3,
  "action": {
    "kind": "request",
    "query": "https://www.youtube.com/watch?v=abcdefghijk"
  }
}

Format de l'événement

Chaque événement a un identifiant stable préfixé par don_ ou evt_. Utilisez cet identifiant pour éviter un traitement en double après une nouvelle tentative.

actor.name contient le nom d’affichage enregistré ou null. message contient du texte ou null. occurred_at correspond à la date du don ; pour les événements de plateforme, seul l’instant d’enregistrement est connu. recorded_at contient toujours l’instant d’enregistrement et détermine la pagination. Tous les horodatages sont en UTC au format ISO 8601.

Pour un événement donation, value contient le montant initial en centimes entiers et currency indique la devise. refunded_amount_cents contient le montant remboursé pour DonoLink, sinon null. Les dons au statut paid sont affichés, y compris l’historique importé dont la source d’importation figure dans platform. Les dons entièrement remboursés et les dons contestés sont exclus. Il s’agit d’un flux d’activité, pas d’un grand livre comptable.

Les événements de la plateforme sont disponibles dans la mesure où DonoLink les a reçus et stockés via une connexion active. L’historique antérieur à la connexion n’est pas récupéré depuis la plateforme. Il n'y a pas de période de conservation garantie ; Les enregistrements supprimés ne peuvent pas être récupérés. Les alertes de test ne sont pas incluses.

Historique et flux en direct

Pour une exportation, utilisez order=asc avec des limites fixes depuis et jusqu'à. Traitez les données et demandez la page suivante en utilisant next_cursor alors que has_more est vrai. Il n'y a aucune limite sur le nombre de pages historiques, mais des limites de demandes s'appliquent.

Une page vide préserve votre curseur existant. Sans curseur précédent ni événement, next_cursor est nul. Les curseurs ne contiennent aucune clé API, mais traitez-les comme des valeurs opaques. Après avoir changé les filtres, démarrez sans curseur.

Pour votre application IRL, utilisez order=asc, un fixe depuis et non jusqu'à. Enregistrez le curseur uniquement après avoir traité les événements. Sondez environ toutes les 5 secondes ; lorsque has_more est vrai, passez directement à la page suivante. La v1 n'a pas de point de terminaison WebSocket ou webhook.

// Node.js: run on your server. Keep the key out of frontend bundles.
const base = new URL('https://donolink.nl/api/v1/activity');
base.searchParams.set('order', 'asc');
base.searchParams.set('limit', '100');
// Persist both this fixed starting point and the returned cursor.
base.searchParams.set('since', '2026-09-07T00:00:00Z');
let cursor = await loadCheckpoint();
for (;;) {
  const url = new URL(base);
  if (cursor) url.searchParams.set('cursor', cursor);
  const response = await fetch(url, {
    headers: { Authorization: 'Bearer ' + process.env.DONOLINK_API_KEY },
    signal: AbortSignal.timeout(15000)
  }).catch(() => null);
  if (!response || response.status === 429 || response.status >= 500) {
    const seconds = Number(response?.headers.get('Retry-After') || 60);
    await new Promise(r => setTimeout(r, seconds * 1000));
    continue;
  }
  if (!response.ok) throw new Error('DonoLink API: ' + response.status);
  const page = await response.json();
  // Implement these storage functions in your app.
  // Process idempotently by event.id, then save the checkpoint.
  for (const event of page.data) await processOnce(event.id, event);
  if (page.pagination.next_cursor) {
    cursor = page.pagination.next_cursor;
    await saveCheckpoint(cursor);
  }
  if (!page.pagination.has_more)
    await new Promise(r => setTimeout(r, 5000));
}

Le flux lit les enregistrements actuellement stockés et ne constitue pas un instantané immuable ni un bus d'événements garanti exactement une fois. Les changements de statut de paiement peuvent supprimer des enregistrements précédemment visibles. Utilisez le traitement idempotent, les tentatives et, si nécessaire, les lectures qui se chevauchent pour la récupération.

Limites et erreurs

Maximum 120 requêtes toutes les 60 secondes par compte, partagées par toutes les clés. Il existe également une limite de 300 requêtes toutes les 60 secondes par adresse IP. HTTP 429 et 503 incluent Retry-After: 60. Attendez aussi longtemps et réessayez avec le même curseur.

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key is invalid, expired or revoked.",
    "request_id": "request-uuid"
  }
}

Chaque réponse a un X-Request-Id ; les réponses d’erreur incluent également error.request_id. Incluez cet identifiant et l’heure lorsque vous contactez l’assistance. Ne partagez jamais votre clé, votre en-tête d’autorisation ou vos journaux de requêtes complets. Utilisez GET pour les données. HEAD et OPTIONS sont disponibles pour les vérifications HTTP ; les méthodes d'écriture renvoient 405.

Intégration sécurisée

Utilisez HTTPS. Ne placez jamais les clés dans les URL, Git, le code du navigateur, localStorage, les outils d’analyse ou les journaux. Les réponses de l’API utilisent Cache-Control: private, no-store. L’API n’autorise pas les requêtes du navigateur provenant d’une autre origine.

Dans une application native personnelle, saisissez votre propre clé et stockez-la dans le trousseau ou le Keystore Android. Pour les applications au service de tiers, utilisez un backend avec des secrets isolés par utilisateur. N'intégrez jamais une clé partagée dans le binaire de l'application.

L'API renvoie uniquement les noms d'affichage, les messages, les valeurs d'événement et des détails de profil limités. Les adresses e-mail, les modes de paiement, les identifiants Stripe, les jetons de plateforme et les paramètres d'administration ne sont pas partagés. Traitez les noms et les messages comme des données personnelles et stockez uniquement ce dont votre intégration a besoin.

Si une clé fuit, révoquez-la immédiatement sous Paramètres → Développeur et créez une remplaçante. Les clés révoquées et expirées, les comptes bloqués et les comptes supprimés ne peuvent pas accéder à l'API.

Les noms et les messages ne sont pas des entrées fiables. Affichez-les sous forme de texte, jamais sous forme de HTML ou de code exécutable. N'automatisez pas les actions de paiement basées sur ce flux.

Widget de don

Vous voulez recevoir des dons sur votre propre site, sans envoyer vos visiteurs vers DonoLink ? Collez cet iframe dans le HTML de votre site et remplacez YOUR_USERNAME par votre nom DonoLink. Aucune clé API n’est nécessaire. Les frais, moyens de paiement, messages, alertes et versements fonctionnent exactement comme sur votre page de dons.

<iframe
  src="https://donolink.nl/embed/YOUR_USERNAME"
  title="DonoLink"
  width="100%"
  height="760"
  style="border:0;max-width:480px"
  allow="payment"
></iframe>

Options : ajoutez ?thema=licht à l’URL pour un thème clair (sombre par défaut) et ?bedrag=500 pour préremplir un montant en centimes. Gardez allow="payment" : sans cet attribut, Apple Pay et Google Pay ne fonctionnent pas dans l’iframe. Le widget fait au maximum 480 pixels de large ; une hauteur d’environ 760 pixels affiche tout le formulaire.

La carte, Apple Pay et Google Pay se finalisent dans le widget, puis le visiteur voit un message de remerciement. Avec Bancontact et Klarna, l’étape de paiement s’ouvre dans un nouvel onglet, car les banques ne se chargent pas dans un autre site ; votre site reste ouvert. Bizum n’est pas disponible dans le widget.

Le widget n’ajoute ni analytics ni bannière de cookies à votre site. Les données de paiement vont directement à Stripe ; votre site ne les voit jamais. Seule la page /embed peut être intégrée sur d’autres sites ; votre tableau de bord et votre page de dons habituelle ne le peuvent pas.

Code avec votre nom et aperçu dans les Paramètres