RECURSO DE API

Imagem

Radiografias e fotos clínicas são vinculadas à ficha do paciente. Os arquivos são armazenados em object storage compatível com S3; nunca no banco de dados.

Acesso Antecipado Toda a API

Endpoints

3 endpoint

Endpoints deste recurso. Cada endpoint é limitado aos dados da clínica à qual a chave de API está vinculada; os endpoints de gravação suportam o cabeçalho Idempotency-Key.

GET /v1/patients/{id}/images Lista as imagens do paciente (radiografias/fotos) Todos os papéis autorizados

POST /v1/patients/{id}/images Envia imagem (S3, stream/presigned) admin · médico · secretário

GET /v1/images/{id}/raw Baixa o arquivo de imagem (presigned) Todos os papéis autorizados

Exemplo de Uso

Listar as imagens do paciente

Requisição

curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"

Resposta

HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

Segurança neste recurso

Segurança não é um recurso, é a própria arquitetura. As garantias que se aplicam a este recurso:

Arquivos grandes (radiografias) não são gravados no disco do BFF; são enviados diretamente ao S3 via stream/presigned.

O acesso ao arquivo bruto é concedido por um link assinado e com validade limitada (presigned); mesmo que o link vaze, ele expira.

Todas as imagens são isoladas ao paciente e à clínica (RLS); nenhuma clínica não autorizada pode acessá-las.

Todo o modelo de segurança →

Formato de Erro

Os erros retornam em um envelope consistente; o código é destinado à máquina, a mensagem ao usuário. Erro interno/stack nunca é vazado.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo inválido: e-mail"
  }
}

Outros Recursos

Pacientes Agendamentos e calendário Odontograma & Tratamento Cobrança e Finanças Estoque Laboratório Lead & CRM Turismo de saúde Relatórios & BI Webhooks Transferência de Dados (Export API)

Deseja acesso antecipado?

Seja o primeiro a saber quando a API for lançada.

Entre em Contato