Développez vos outils de streaming

Démarrage rapide

Utilisez l'API depuis votre propre serveur ou application personnelle. Tous les points de terminaison sont en lecture seule et utilisent JSON. 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.

Chaque clé dispose de la permission fixe activity:read et est liée à votre compte. Elle ne donne aucun droit d’écriture, de paiement ou d’administration. OAuth pour les applications utilisées par plusieurs 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.

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.