Introdução

Visão geral da API CBCTHub v1

Todos os sistemas operacionais·cbcthub.com/pt/status →

O CBCTHub é uma plataforma na nuvem para centros de radiologia odontológica. A API REST v1 permite que seu sistema externo (software clínico, marketplace, sistema próprio) envie exames DICOM e receba um link com sua marca do visualizador 3D em poucas linhas de código.

ℹ Início rápido

  1. Crie uma conta grátis e gere uma API key em Ajustes → API.
  2. Chame POST /api/v1/exams com metadados do paciente + lista de arquivos.
  3. Envie os arquivos DICOM com PUT às URLs pré-assinadas e finalize com /confirm.

A integração completa leva ~2 horas com um dev sênior, ou 1 dia com um júnior.

O que a API resolve

  • Upload direto ao R2 (sem proxy): rápido mesmo com exames de 500 MB+
  • Link compartilhável com a marca do seu centro (logo, cores, domínio)
  • Visualizador 3D embutível via iframe
  • Activity log: você sabe quando e quem abriu cada exame
  • Rate limits generosos: Free 100/h, Pro 1.000/h, Clínica 5.000/h, Ultra 10.000/h, Enterprise sob medida
  • Idempotência no confirm: sua integração pode reintentar sem duplicar
  • Webhooks em tempo real: HMAC SHA-256, retentativas automáticas, audit log
  • API de laudos: enviar PDFs + assinatura eletrônica com QR público
  • Sandbox / Test mode: keys cbct_test_* isoladas, sem consumir storage nem cota do plano
  • Upload de ZIP server-side: 1 GB de ZIP por exame, até 1,6 TB por arquivo individual extraído
  • OpenAPI 3.1 oficial em /openapi.json: importável no Postman/Insomnia/Bruno, gera SDKs
  • Header X-CBCTHub-Version: fixe a versão e migre com calma quando publicarmos mudanças

Endpoints em resumo

GET/api/v1/me

Verificar key + ver conta

POST/api/v1/exams

Criar exame + obter URLs de upload (modo files ou zip)

GET/api/v1/exams

Listar exames (paginado)

GET/api/v1/exams/{id}

Detalhes de um exame

POST/api/v1/exams/{id}/confirm

Marcar upload como concluído (modo files)

POST/api/v1/exams/{id}/process-zip

Descompactar server-side + marcar ready (modo zip)

DELETE/api/v1/exams/{id}

Excluir exame

POST/api/v1/exams/{id}/report

Enviar PDF de laudo

GET/api/v1/exams/{id}/report

Ler laudo vigente + assinatura

DELETE/api/v1/exams/{id}/report

Excluir laudo (idempotente)

POST/api/v1/exams/{id}/report/sign

Assinar laudo eletronicamente

POST/api/v1/webhooks

Criar subscription de webhook

GET/api/v1/webhooks

Listar subscriptions de webhook

PATCH/api/v1/webhooks/{id}

Atualizar events, enabled_live/test, description

DELETE/api/v1/webhooks/{id}

Excluir subscription

POST/api/v1/webhooks/{id}/test

Enviar test.ping ao seu endpoint

GET/api/v1/webhooks/{id}/deliveries

Audit log das últimas 50 entregas

Teste em 30 segundos

curl
curl https://cbcthub.com/api/v1/me \
  -H "Authorization: Bearer cbct_live_..."

Testar API agora →

Assine eventos com webhooks

Receba um POST à sua URL quando um exame é confirmado ou um laudo é assinado. Assinatura HMAC SHA-256 + retentativas automáticas.

curl
curl -X POST https://cbcthub.com/api/v1/webhooks \
  -H "Authorization: Bearer cbct_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://miclinica.com/webhooks/cbcthub",
    "events": ["exam.confirmed", "report.signed"]
  }'

Por onde seguir

Contato

Se seu sistema é um PMS odontológico, marketplace de centros de radiologia ou software clínico próprio, escreva para soporte@cbcthub.com ou WhatsApp +56 9 7632 9096. Construímos integrações personalizadas para clientes Clínica, Ultra e Enterprise.

Próximo →

Autenticação