API-Referenz
Replays
Endpoint POST /api/v1/replays/:replayId/segments/:n and /meta
Das Browser-SDK verwendet diese beiden Endpoints; Sie würden sie nur aus einem eigenen Recorder aufrufen. Ein Replay besteht aus bis zu 500 Segmenten von rrweb-Events.
1Segmente
POST /api/v1/replays/<replayId>/segments/<n>: replayId hat 32 Hex-Zeichen, n ist 0 bis 499. Schlüssel (öffentlich oder geheim) in X-Blipit-Key oder ?key=, optionale Instanz. Der Body ist ein JSON-Array von rrweb-Events, roh oder gzip (Content-Encoding: gzip), bis 2 MB, entpackt höchstens 32 MB. Das erste Segment beansprucht ein Replay aus dem Monatskontingent.
2Metadaten
POST /api/v1/replays/<replayId>/meta mit einem JSON-Body bis 16 KB: url, duration (ms), error_ids (Event-IDs), browser, os. Das Replay muss in diesem Projekt bereits existieren.
3Antworten
202 {accepted: true, duplicate?} gespeichert. 202 {accepted: false, reason: 'replay_quota'} der Workspace hat seine Replays für den Monat aufgebraucht; Aufzeichnung stoppen. 202 {accepted: false, reason: 'replay_full'} das Replay hat 500 Segmente oder 20 MB erreicht. 400 ungültige ID, Segmentnummer oder Body. 409 die Replay-ID gehört zu einem anderen Projekt. 404 Metadaten für ein unbekanntes Replay.
Gut zu wissen
- 1.200 Requests pro Minute und Schlüssel.
- Requests von bekannten Bots werden mit 202 beantwortet und verworfen.
- Segmente werden wie gesendet gespeichert und dem Player 20 auf einmal zurückgegeben.
- 409, wenn die Daten von einer anderen Plattform kommen als der des Projekts, zum Beispiel {"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"}. Events, Sessions, Logs, OTLP-Traces und -Metriken, Fehlerberichte, Replays und Web Vitals antworten alle so. Abgelehnte Daten werden nicht gespeichert und nicht auf das Kontingent angerechnet. Die Blipit-SDKs schreiben diesen Fehler einmal ins Log und senden für den Rest der Laufzeit nichts mehr. Zur Behebung ein Projekt für diese Plattform anlegen und dessen Schlüssel verwenden.
Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.