Módulos
Como a HumanTrack API se organiza em módulos, o que está disponível hoje e a direção dos próximos módulos.
A API é organizada em módulos. Cada módulo expõe uma capacidade clínica da plataforma HumanTrack e se apoia na mesma base comum de profissionais, pacientes, vínculo de conta e webhooks. Hoje a API expõe o módulo Instrumentos. Nexo, Registro de Sessão e Artemi são os próximos módulos: ainda não fazem parte deste contrato e não têm data para chegar à API.
Base comum
Todo módulo usa as mesmas peças:
| Peça | O que faz |
|---|---|
| Autenticação | API Key e API Secret em cada requisição. |
| Profissionais | Cadastro e consulta dos profissionais vinculados a você, cada um com o seu externalId. |
| Pacientes | Pacientes de cada profissional: cadastro, atualização, inativação e reativação. |
| Vínculo de conta | Vínculo de um profissional que já usa a HumanTrack à sua plataforma, com a confirmação dele. |
| Webhooks | Eventos que a HumanTrack envia à sua plataforma, assinados com HMAC-SHA256. |
Disponível hoje: Instrumentos
O módulo Instrumentos cobre o ciclo da mensuração clínica, da escolha do instrumento à leitura da evolução do paciente.
| Capacidade | O que a API entrega | Referência |
|---|---|---|
| Biblioteca | Instrumentos da biblioteca, com filtro por tag, e o detalhe de cada um: questões, opções, subescalas e faixas de interpretação, em JSON ou PDF. | Instrumentos |
| Aplicação | Atribuição de um instrumento a um paciente, com recorrência (NOW, ONCE, DAILY, WEEKLY, BIWEEKLY, MONTHLY), alteração de recorrência, finalização e cancelamento. | Aplicações |
| Submissões e escores | Cada solicitação de resposta, com as respostas, a pontuação calculada e as datas de solicitação e resposta. Também cancelamento e reenvio da notificação ao paciente. | Submissões |
| Notificações | Notificações enviadas ao paciente para um instrumento. | Notificações |
| Gráfico de escores | Dados prontos para gráfico: uma série para o escore global e uma por subescala, com as faixas de interpretação. | Relatórios |
| Análise longitudinal | Análise da trajetória do paciente em um instrumento, gerada por IA, com consulta prévia de estado para saber se a chamada vai gerar uma nova análise. | Relatórios |
| Relatório em PDF | Relatório das submissões do paciente em um instrumento, em PDF binário ou em base64. | Relatórios |
| Recomendação de instrumentos | Sugestão de instrumentos da biblioteca a partir da descrição de um caso clínico, com histórico de recomendações. | Recomendação |
A análise longitudinal e a recomendação apoiam a interpretação e a escolha do profissional; não substituem o julgamento clínico. A análise longitudinal responde 403 quando o plano do profissional não inclui análise por IA. Na recomendação, não inclua em case_text dados que identifiquem o paciente.
Os conceitos do módulo (instrumento, aplicação, submissão e seus status) estão em Conceitos.
Próximos módulos
Os módulos abaixo indicam a direção da API. Nenhum deles faz parte do contrato atual: não há endpoints, data nem compromisso de disponibilidade, e o escopo que chegaria à API ainda não está definido. Quando um módulo entrar no contrato, ele aparece na Referência da API e no Changelog.
Nexo
Em breve. Pesquisa de evidência científica: permite investigar uma pergunta em linguagem natural e receber uma síntese citada, com os estudos do mesmo corpus e a cobertura da busca explícita. A pesquisa não recebe contexto de paciente, não promete recuperar toda a literatura e não substitui uma revisão sistemática.
Registro de Sessão
Em breve. Transcrição do áudio da sessão, diarização das falas e geração automatizada das notas da sessão. A direção inclui apoiar a evolução de prontuário a partir desse registro, sempre revisada pelo profissional.
Artemi
Em breve. A Artemi é a IA clínica da HumanTrack, especializada na clínica em saúde mental brasileira, que apoia o raciocínio clínico a partir dos dados registrados na plataforma. Ela assiste o profissional e nunca substitui o julgamento clínico: não produz diagnóstico conclusivo nem recomenda medicação.
Se a sua integração depende de um desses módulos, converse com a equipe HumanTrack.