Integrações Internas

Documentação do Conexões

Canal principal para integração entre o site e sistemas internos do laboratório. Use este domínio para recebimento de resultados, cargas iniciais, sincronizações e webhooks operacionais.

Base https://conexoes.laboratoriotiezzi.com.br

Autenticação Bearer Token por provedor

Formato application/json

Endpoints disponíveis

GET /api

Retorna um resumo rápido do serviço de conexões.

GET /api/status

Endpoint de status para monitoramento e validação da integração.

POST /api/resultados/full

Recebe carga completa de resultados e identifica automaticamente o provedor pelo token.

GET/POST /api/webhook/{origem?}

Entrada flexível para integrações internas e notificações de sistemas legados.

Exemplo de envio

Exemplo de envio do lote inicial de resultados para o endpoint principal de integração.

curl -X POST "https://conexoes.laboratoriotiezzi.com.br/api/resultados/full" \
  -H "Authorization: Bearer <TOKEN_DO_PROVEDOR>" \
  -H "Content-Type: application/json" \
  -H "X-Integration-Source: sistema-interno" \
  -H "X-Integration-Event: carga-inicial" \
  --data '{
    "paciente": {
      "cpf": "12345678900",
      "nome": "Paciente Exemplo"
    },
    "exame": {
      "codigo": "ABC123",
      "nome": "Hemograma"
    },
    "laudo": {
      "status": "liberado",
      "resultado": "Normal"
    }
  }'

Exemplo de payload

{
  "paciente": {
    "cpf": "12345678900",
    "nome": "Paciente Exemplo"
  },
  "exame": {
    "codigo": "ABC123",
    "nome": "Hemograma"
  },
  "laudo": {
    "status": "liberado",
    "resultado": "Normal"
  }
}

Diretrizes

Token por Provedor

Cada empresa ou sistema integrado recebe um token exclusivo. O servidor armazena apenas o hash desse token e identifica o provedor que enviou a carga.

Primeira Carga

Na fase inicial, envie o payload completo em JSON. O sistema registra o corpo bruto e lista as chaves detectadas para acelerar o mapeamento dos campos.

Boas Práticas

Sempre envie Content-Type application/json, cabeçalhos X-Integration-Source e X-Integration-Event, e mantenha o token restrito ao sistema que fará a integração.

Resposta esperada

{
  "ok": true,
  "message": "Carga recebida com sucesso.",
  "request_id": "3292a380-584e-42a4-b9be-9b39255652d1",
  "received_at": "2026-04-20T15:09:07+00:00",
  "provider": {
    "id": "sistema_interno",
    "name": "Sistema Interno do Laboratorio"
  },
  "detected_keys": [
    "exame",
    "exame.codigo",
    "exame.nome",
    "laudo",
    "laudo.resultado",
    "laudo.status",
    "paciente",
    "paciente.cpf",
    "paciente.nome"
  ]
}

Observação de segurança

Tokens reais de integração não são exibidos publicamente nesta página. Cada fornecedor recebe um token próprio, e o sistema identifica automaticamente qual provedor enviou a carga.