Referencia de la API
Replays
Endpoint POST /api/v1/replays/:replayId/segments/:n and /meta
El SDK de navegador usa estos dos endpoints; solo los llamarías desde un grabador personalizado. Un replay son hasta 500 segmentos de eventos rrweb.
1Segmentos
POST /api/v1/replays/<replayId>/segments/<n>: replayId son 32 caracteres hexadecimales, n va de 0 a 499. Clave (pública o secreta) en X-Blipit-Key o ?key=, instancia opcional. El cuerpo es un array JSON de eventos rrweb, en bruto o con gzip (Content-Encoding: gzip), de hasta 2 MB, que descomprimido llega como máximo a 32 MB. El primer segmento consume un replay de la cuota mensual.
2Metadatos
POST /api/v1/replays/<replayId>/meta con un cuerpo JSON de hasta 16 KB: url, duration (ms), error_ids (ids de eventos), browser, os. El replay ya debe existir en este proyecto.
3Respuestas
202 {accepted: true, duplicate?} guardado. 202 {accepted: false, reason: 'replay_quota'} el espacio de trabajo agotó sus replays del mes; deja de grabar. 202 {accepted: false, reason: 'replay_full'} el replay alcanzó 500 segmentos o 20 MB. 400 id, número de segmento o cuerpo incorrectos. 409 el id del replay pertenece a otro proyecto. 404 meta para un replay desconocido.
Conviene saber
- 1.200 peticiones por minuto y clave.
- Las peticiones de bots conocidos se responden con 202 y se descartan.
- Los segmentos se guardan tal como se envían y se sirven al reproductor de 20 en 20.
- 409 cuando los datos vienen de una plataforma distinta a la del proyecto, por ejemplo {"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"}. Eventos, sesiones, logs, trazas y métricas OTLP, informes de errores, replays y web vitals responden igual. Los datos rechazados no se guardan ni cuentan para la cuota. Los SDK de Blipit registran este error una vez y dejan de enviar durante el resto de la ejecución. Para solucionarlo, crea un proyecto para esa plataforma y usa su clave.
¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.