Votre flux d'activité dans une application de streaming IRL : relisez les dons et les événements

Lors d’un stream IRL, vous avez des besoins différents de ceux derrière votre bureau. Vous voulez pouvoir voir brièvement qui a fait un don, quel message lui appartient et quelle autre activité vous avez manquée. Votre propre application peut afficher cela exactement comme vous le souhaitez. Le API de flux d'activités DonoLink délivre les événements stockés ; votre propre application détermine la présentation et la façon dont vous les traitez.

Un stream actuel est bien plus que simplement actualiser une liste

Si vous récupérez uniquement les dix événements les plus récents avec chaque requête, vous pouvez ignorer les événements plus anciens lors d'un stream chargé ou d'une longue panne de réseau. Par conséquent, pour une intégration continue, vous souhaitez parcourir le flux à partir d’un point connu. Utiliser l'ordre croissant avec ordre=asc et enregistrez le curseur renvoyé par l'API.

Au démarrage de votre intégration, définissez-en une fixe depuis -frontière. Ce filtre se base sur le moment où DonoLink a enregistré un événement, et non sur la date originale d'un don importé. N'ajustez pas la bordure sur « maintenant » à chaque fois pendant l'interrogation : cela modifiera la requête et votre curseur existant expirera.

La boucle de lecture pour votre application IRL

1. Demandez un maximum de 100 événements avec votre clé API personnelle, ordre=asc et vos filtres habituels.
2. Traitez chaque événement en fonction de son identifiant unique. Si cet ID a déjà été traité, ne réessayez pas l'action correspondante.
3. Enregistrer pagination.next_cursor seulement après que tous les événements de la page ont été traités avec succès.
4. Est-ce has_more vrai, alors lisez immédiatement la page suivante. Sinon, attendez environ cinq secondes.
5. Enregistrez les filtres et le curseur sur votre propre stockage afin de pouvoir reprendre après le redémarrage de votre application.

Le la documentation comprend un exemple Node.js avec cette boucle. Vous remplissez vous-même les fonctions avec lesquelles vous traitez les événements et enregistrez le curseur. Une page vide signifie qu'il n'y a aucun nouvel événement enregistré pour cette requête à ce moment-là. Pour un curseur existant, l'API renvoie ce curseur afin que vous puissiez continuer à visualiser à partir du même point.

Que faire en cas de mauvaise couverture ?

Une erreur réseau n’est pas une raison pour effacer votre curseur. Laissez votre application afficher temporairement un état de connexion, attendez et réessayez la même demande. Au HTTP 429 ou 503, DonoLink renvoie Réessayez après : 60 retour. Respectez ce temps d'attente. Si la clé est expirée ou révoquée, vous recevrez 401 ; alors une nouvelle clé est nécessaire au lieu de réessayer sans fin.

Le flux n’est pas un bus d’événement garanti exactement une fois. Un paiement peut ultérieurement être remboursé ou contesté, et les enregistrements stockés peuvent disparaître. Par conséquent, rendez votre traitement résistant à la répétition. Pour la récupération, vous pouvez relire une période qui se chevauche et ignorer les ID d'événement connus. N'utilisez pas le flux pour diriger des paiements automatiques ou d'autres actions irréversibles.

Choisissez quelles informations sont pertinentes en cours de route

Avec type=don limiter le flux aux dons. Avec plateforme=donolink sélectionnez vos dons DonoLink ; les dons importés ont leur propre source. Omettez les filtres si vous souhaitez également voir les suivis, les abonnements, les abonnés offerts, les acclamations et les raids enregistrés. Les champs et unités d'événement se trouvent dans le référence de l'événement .

Gardez votre interface mobile calme : par exemple, le nom d'écran, le message et la valeur du dernier événement. Afficher les montants monétaires sous forme de devise et de centimes ; montrez les diamants TikTok comme des diamants. Les noms d’écran et les messages sont des entrées de tiers, alors affichez-les sous forme de texte brut. Un message ne doit jamais devenir HTML ou code dans votre application.

Enregistrez votre clé API en dehors de votre image de flux

Entrez votre propre clé dans une application native personnelle et enregistrez-la dans le trousseau ou le Keystore Android. Ne placez jamais une clé partagée dans une application que vous distribuez à d’autres. Si vous créez pour plusieurs streamers, chaque compte a besoin de ses propres secrets et données. L'API v1 ne dispose pas encore de flux OAuth permettant à d'autres utilisateurs d'accorder une autorisation à votre application.

Commencez par le introduction à l'API Développeur DonoLink puis placez votre clé en dessous Paramètres → Développeur . Avez-vous particulièrement besoin d’un lien de don pour votre stream ? Ensuite, vous pouvez d'abord créer un compte gratuit et toi créer une page de don , sans créer d'application vous-même.