Checking…IdiomaApp

API Morpheus Clinical

Documentação de integração para equipas clínicas e de engenharia. Estrutura clara, previsível e pronta para produção.

Base URL

https://morpheus.pt/api

Autenticação

Use `Authorization: Bearer <token>` em todas as chamadas. Tokens devem ser geridos no backend da sua organização.

Authorization: Bearer <token>

Endpoint principal

Submeta EDF + metadados clínicos e receba staging, métricas e pistas de revisão numa resposta estruturada.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
file	ficheiro (EDF)	Sim	Registo de polissonografia em formato EDF.
age	inteiro	Sim	Idade do paciente em anos (0–120).
sex	string	Sim	Sexo biológico: 'M' ou 'F'.

Exemplo de pedido

curl -X POST https://morpheus.pt/api/analyze \
  -H "Authorization: Bearer $MORPHEUS_TOKEN" \
  -F "file=@study.edf" \
  -F "age=58" \
  -F "sex=F"

Exemplo de resposta

{
  "job_id": "job_01...",
  "status": "success",
  "sleep_metrics": { "...": "..." },
  "oximetry": { "...": "..." },
  "sleep_stages": [ ... ],
  "findings": { "...": "..." }
}

Endpoint de relatório

Submeta EDF + metadados clínicos e receba um relatório PDF ou metadados de relatório do pipeline configurado.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
file	ficheiro (EDF)	Sim	Registo de polissonografia em formato EDF.
age	inteiro (query)	Sim	Idade do paciente em anos.
sex	string (query)	Sim	Sexo biológico: 'M' ou 'F'.
language	string	Não	Localidade do relatório, p.ex. 'pt-PT' ou 'en-US'. Por omissão 'en-US'.

Exemplo de pedido

curl -X POST "https://morpheus.pt/api/report?age=58&sex=F" \
  -H "Authorization: Bearer $MORPHEUS_TOKEN" \
  -F "file=@study.edf" \
  -F "language=pt-PT"

Exemplo de resposta

{
  "status": "success",
  "job_id": "job_01...",
  "report_url": "https://morpheus.pt/reports/report_01.pdf",
  "expires_at": "2026-12-31T23:59:59Z"
}

Erros e fiabilidade

Códigos HTTP padrão com mensagens semânticas. Recomendamos retry com backoff exponencial para falhas transitórias.

Código	Significado	Ação recomendada
400	Pedido inválido	Verifique o payload e campos obrigatórios.
401	Não autorizado	Confirme o token Bearer e os scopes.
422	EDF não processável	EDF não pôde ser lido. Valide canais e cabeçalhos.
429	Limite atingido	Aguarde e tente novamente após o Retry-After.
500	Erro do servidor	Transitório — tente com backoff exponencial.

Limites e quotas

Limites por defeito para contas clínicas. Quotas maiores disponíveis sob pedido para integrações de alto volume.

Pedidos por minuto: 100 / min
Tamanho máximo do EDF: 500 MB
Tempo de resposta /analyze: ~ 30–90 s
Retenção do relatório: 30 dias

Pedir acesso à API

Para onboarding técnico, gestão de quotas e validação clínica do payload, contacte a equipa Morpheus.

Falar com a equipa

hello@morpheus.pt