BeHeart Coherence

Visão geralO programa de coerência cardíaca da sua empresa

Medições — total

–

Medições — 30 dias

–

Usuários

–

Pontos distribuídos

–

Coerência média

–

score 0–1

Medições por dia — últimos 30 dias

Testar o widget

Gera um token de sessão de teste e abre a prática como um usuário final veria dentro do seu app. Na integração real, o token é emitido pelo seu backend via POST /v1/tokens.

Últimos resultados

Data	Usuário	Duração	Em coerência	Score	Pontos

ResultadosTodas as medições da sua empresa, mais recentes primeiro

Data	Usuário	Duração	Em coerência	FC média	Score	Pontos	HeartCoins

API & LogsSó as chamadas da SUA integração (backend com API key + widget) — navegar neste portal não conta aqui

Chamadas — 30 dias

–

Erros (4xx/5xx)

–

Latência média

–

Rate limit

120 /min

por credencial

Chamadas por dia — últimos 30 dias

Endpoints mais usados — 30 dias

Endpoint	Chamadas

Log de chamadas

Request ID	Quando	Endpoint	Status	ms

Chave de APIA credencial da sua empresa — vive apenas no seu servidor

Identificador: — · Ativa
A chave completa (bhk_...) é exibida uma única vez ao ser gerada. Guarde-a numa variável de ambiente do seu backend (ex.: BEHEART_API_KEY) — ela serve para ler os resultados. Se perdeu ou vazou, gere uma nova: a anterior morre na hora e a URL do widget continua funcionando normalmente (ela não depende desta chave).

Boas práticas

A chave nunca vai para o navegador, app mobile ou repositório de código — só circula em chamadas servidor-a-servidor.
No browser do usuário final circula apenas o token de sessão (JWT descartável, expira em minutos).
Suspeita de vazamento? Gere uma nova chave aqui — a revogação é imediata.
Guarde em env var: BEHEART_API_KEY=bhk_... e leia no código via process.env / equivalente.

Endpoints disponíveis para a sua chave

Método	Endpoint	O que faz
GET	/v1/results	Lista medições (filtros: limit, subject_id)
GET	/v1/summary	Totais e diário de 7 dias de um usuário
GET	/v1/subjects	Todos os usuários com totais agregados
GET	/v1/usage	Uso agregado da conta (volume, pontos, série diária)
GET	/v1/requests	Log de chamadas da sua integração (Request IDs)
POST	/v1/tokens	(Avançado) Emite token de sessão manualmente — a URL fixa do widget já faz isso por você

Referência completa, com parâmetros e exemplos: documentação da API ↗

IntegraçãoCopie a URL, guarde a chave na env, embuta e receba — pronto

Passo 1 — Copie a URL do seu widget (fixa, gerada uma única vez)

Esta URL é sua e não muda nunca — não precisa gerar de novo. Guarde no config do seu front:

Para identificar quem está medindo, acrescente &user=ID na hora de abrir (um id interno do seu sistema — não use CPF/e-mail). É esse id que faz o histórico da pessoa persistir.

Ou escaneie com o celular para abrir a prática direto — útil para testar a medição com a câmera:

Passo 2 — Guarde a API key na env do seu backend

A chave bhk_... (aba Chave de API) fica numa variável de ambiente do seu servidor e serve para ler os resultados. Ela nunca aparece no site/app. Se vazar, gere outra — a URL do widget continua a mesma.

# .env do seu backend
BEHEART_API_KEY=bhk_...

Passo 3 — Embuta o widget

allow="camera" é obrigatório e a página precisa estar em HTTPS. Idiomas: pt (padrão), en, es.

Passo 4 — Receba os resultados

Em tempo real, na própria página (postMessage):

E no seu backend, com a API key da env (fonte de verdade para premiar):

Referência completa

Exemplos prontos em JavaScript, React e React Native, endpoints, erros e LGPD: documentação da API ↗

Bem-vindo(a)!