RECURSO DE API

Laboratório

Crie pedidos de laboratório e acompanhe o status de ponta a ponta; gerencie os laboratórios conveniados. Antecipe os atrasos.

Acesso Antecipado Toda a API

Endpoints

7 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/lab-orders Lista os pedidos de laboratório Usuário autorizado

POST /v1/lab-orders Cria um pedido de laboratório Usuário autorizado

GET /v1/lab-orders/{id} Obtém os detalhes do pedido Usuário autorizado

PUT /v1/lab-orders/{id} Atualiza o pedido Usuário autorizado

POST /v1/lab-orders/{id}/status Altera o status do pedido Usuário autorizado

GET /v1/labs Lista os laboratórios conveniados Usuário autorizado

POST /v1/labs Adiciona um laboratório Usuário autorizado

Exemplo de Uso

Criar pedido de laboratório

Requisição

curl -X POST https://api.udentiva.com/v1/lab-orders \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","lab_id":"lab-3","type":"crown"}'

Resposta

HTTP/1.1 201 Created
{
  "id": "lo-204",
  "status": "created",
  "created_at": "2026-06-24T09:25:00Z"
}

Segurança neste recurso

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

Os pedidos de laboratório e os registros de laboratório são isolados à sua clínica (RLS).

As transições de estado são feitas via action endpoint e registradas no log de auditoria.

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 Imagem 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