Replays

Endpoint POST /api/v1/replays/:replayId/segments/:n and /meta

Le SDK navigateur utilise ces deux endpoints ; vous ne les appelleriez que depuis un enregistreur personnalisé. Un replay compte jusqu'à 500 segments d'événements rrweb.

1Segments

POST /api/v1/replays/<replayId>/segments/<n> : replayId fait 32 caractères hexadécimaux, n va de 0 à 499. Clé (publique ou secrète) dans X-Blipit-Key ou ?key=, instance facultative. Le corps est un tableau JSON d'événements rrweb, brut ou gzip (Content-Encoding: gzip), jusqu'à 2 Mo, décompressé à au plus 32 Mo. Le premier segment réserve un replay du quota mensuel.

2Métadonnées

POST /api/v1/replays/<replayId>/meta avec un corps JSON jusqu'à 16 Ko : url, duration (ms), error_ids (ids d'événements), browser, os. Le replay doit déjà exister dans ce projet.

3Réponses

202 {accepted: true, duplicate?} stocké. 202 {accepted: false, reason: 'replay_quota'} l'espace de travail a épuisé ses replays du mois ; arrêtez d'enregistrer. 202 {accepted: false, reason: 'replay_full'} le replay a atteint 500 segments ou 20 Mo. 400 id, numéro de segment ou corps invalide. 409 l'id de replay appartient à un autre projet. 404 meta pour un replay inconnu.

Bon à savoir

  • 1 200 requêtes par minute et par clé.
  • Les requêtes des bots connus reçoivent 202 et sont écartées.
  • Les segments sont stockés tels qu'envoyés et renvoyés au lecteur 20 à la fois.
  • 409 quand les données viennent d'une autre plateforme que celle du projet, par exemple {"error": "This project is for iOS. Create a separate Android project in Blipit and use its key.", "reason": "platform_mismatch", "project_platform": "ios", "sent_platform": "android"}. Les événements, sessions, logs, traces et métriques OTLP, rapports de bug, replays et web vitals répondent tous ainsi. Les données refusées ne sont pas enregistrées et ne comptent pas dans le quota. Les SDK Blipit écrivent cette erreur une fois dans les logs et n'envoient plus rien pendant le reste de l'exécution. Pour corriger, créez un projet pour cette plateforme et utilisez sa clé.

Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.