Referência da API

Sessões

Endpoint POST /api/v1/sessions

As sessões alimentam a adoção e as taxas sem falha na página de Releases. Envie sessões individuais ou contagens agregadas; uma sessão precisa de uma release.

1Requisição

Chave pública em X-Blipit-Key ou ?key= (para sendBeacon). Um objeto de sessão, {sessions: [...]} com no máximo 100, ou {release, environment?, aggregates: [...]}. Uma sessão: sid (8 a 64 letras, dígitos, hifens), release (obrigatório), environment?, status (ok, errored, abnormal, crashed), errors? (uma contagem acima de 0 significa errored), did? (id do usuário, armazenado apenas como prefixo de hash), started? (ISO ou segundos epoch). Enviar o mesmo sid novamente mantém o pior status.

sh
curl "https://in.blipit.io/api/v1/sessions" \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <public key>" \
  -d '{"sessions":[{"sid":"c1f2a9d4e7b8","did":"user-42","status":"crashed","release":"shop@1.4.2","environment":"production"}]}'

2Respostas

202 {accepted: n}. 400 quando nada tem sid e release, ou mais de 100 sessões. 401 chave desconhecida.

Bom saber

  • 3.000 requisições por minuto por chave.
  • O SDK de navegador as envia por você com autoSessionTracking: true e uma release definida; os itens de sessão dos SDKs do Sentry também são lidos.
  • As sessões são mantidas por 90 dias.

Travou? Envie um e-mail para support@blipit.io. As chaves e o DSN exato de cada projeto ficam em Chaves de API no app.blipit.io.