Skip to main content

​
Developer Platform

A API do Laudos.AI permite integrar laudos radiologicos, templates e envio para PACS/RIS diretamente no seu sistema hospitalar.
Todas as requisicoes requerem autenticacao via API Key. Obtenha sua chave em Configuracoes > Integracoes.

​
Recursos da API

Laudos

CRUD completo de laudos radiologicos com suporte a HTML e metadados DICOM

Templates

Gerencie templates de laudos com categorias e tipos de exame

PACS/RIS

Envie laudos via HL7 ORU^R01, DICOMweb STOW-RS ou MV Soul XML

Webhooks

Receba notificacoes em tempo real sobre eventos

​
Quick Start

​
1. Obtenha sua API Key

Acesse copilot.laudos.ai/settings/integrations e gere uma nova chave. Sua chave tera o formato: 
sk_live_SUA_CHAVE_AQUI

​
2. Faca sua primeira requisicao

curl -X GET "https://copilot.laudos.ai/api/v1/reports?limit=10" \
  -H "Authorization: Bearer sk_live_xxx"

​
Base URL

https://copilot.laudos.ai/api/v1

​
Autenticacao

Todas as requisicoes requerem autenticacao via Bearer token: 
Authorization: Bearer sk_live_SUA_CHAVE_AQUI
API Keys sao geradas em Configuracoes > Integracoes na plataforma. Cada chave possui permissoes configuradas: reports, templates, pacs.
Nunca exponha sua API Key em codigo client-side ou repositorios publicos. Use variaveis de ambiente no servidor.

​
Rate Limits

PlanoRequisicoes/min
Free10
Pro60
Enterprise300
Headers de rate limit incluidos em todas as respostas: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1705312800
Ao receber HTTP 429, aguarde o tempo indicado no header Retry-After antes de tentar novamente.

​
Formato de Resposta

​
Sucesso

{
  "data": { ... },
  "meta": {
    "total": 100,
    "limit": 10,
    "offset": 0
  }
}

​
Erro

{
  "error": "Mensagem descrevendo o problema"
}

​
Codigos de Erro

Codigo HTTPDescricao
400Requisicao malformada
401API Key invalida ou ausente
403Sem permissao para este recurso
404Recurso nao encontrado
409Conflito (ex: nome duplicado)
429Limite de requisicoes excedido
500Erro interno do servidor

​
Seguranca

  • Todas as conexoes usam TLS 1.3
  • API Keys sao armazenadas com hash SHA-256
  • Dados em conformidade com LGPD
  • Armazene chaves em variaveis de ambiente ou secrets managers
  • Implemente retry com backoff exponencial para falhas transientes
  • Valide webhooks usando o header X-Laudos-Signature

​
Suporte