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.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.