Introducción

Visión general de la API CBCTHub v1

Todos los sistemas operativos·cbcthub.com/es/status →

CBCTHub es una plataforma cloud para centros radiológicos dentales. La API REST v1 permite que tu sistema externo (software clínico, marketplace, sistema propio) suba exámenes DICOM y reciba un link branded del visor 3D en pocas líneas de código.

ℹ Inicio rápido

  1. Crea una cuenta gratis y genera una API key en Ajustes → API.
  2. Llama a POST /api/v1/exams con metadata del paciente + lista de archivos.
  3. Sube los archivos DICOM con PUT a las URLs presignadas y confirma con /confirm.

Toda la integración te puede tomar 2 horas con un dev senior, o 1 día con un junior.

Lo que la API te resuelve

  • Subida directa a R2 (sin proxy): rápido incluso con tomografías de 500 MB+
  • Link compartible con la marca de tu centro (logo, colores, dominio)
  • Visor 3D online embebible vía iframe
  • Activity log: sabes cuándo y quién abrió cada examen
  • Rate limits generosos: Free 100/h, Pro 1.000/h, Clínica 5.000/h, Ultra 10.000/h, Enterprise a medida
  • Idempotencia en confirm: tu integración puede reintentarse sin duplicar
  • Webhooks en tiempo real: HMAC SHA-256, retries automáticos, audit log
  • API de informes radiológicos: subir PDF + firma electrónica con QR público
  • Sandbox / Test mode: keys cbct_test_* aisladas, sin descuento de storage ni cuota
  • Upload ZIP server-side: 1 GB de ZIP por examen, hasta 1,6 TB por archivo individual extraído
  • OpenAPI 3.1 oficial en /openapi.json: importable a Postman/Insomnia/Bruno, genera SDKs
  • Versionado X-CBCTHub-Version: pinear versión y migrar con calma cuando publiquemos cambios

Endpoints en un vistazo

GET/api/v1/me

Verificar key + ver cuenta

POST/api/v1/exams

Crear examen + obtener URLs de upload (modo files o zip)

GET/api/v1/exams

Listar exámenes (paginado)

GET/api/v1/exams/{id}

Detalle de un examen

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

Marcar upload terminado (modo files)

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

Descomprimir server-side + marcar ready (modo zip)

DELETE/api/v1/exams/{id}

Eliminar examen

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

Subir PDF de informe

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

Leer informe vigente + firma

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

Eliminar informe (idempotente)

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

Firmar informe electrónicamente

POST/api/v1/webhooks

Crear subscription de webhook

GET/api/v1/webhooks

Listar subscriptions de webhook

PATCH/api/v1/webhooks/{id}

Actualizar events, enabled_live/test, description

DELETE/api/v1/webhooks/{id}

Eliminar subscription

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

Enviar test.ping a tu endpoint

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

Audit log de las últimas 50 entregas

Pruébala en 30 segundos

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

Probar API ahora →

Suscríbete a eventos con webhooks

Recibe un POST a tu URL cuando un examen se confirma o un informe se firma. Firma HMAC SHA-256 + reintentos automáticos.

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 dónde seguir

Contacto

Si tu sistema es un PMS dental, marketplace de centros radiológicos o software clínico propio, escríbenos a soporte@cbcthub.com o por WhatsApp al +56 9 7632 9096. Construimos integraciones a medida para clientes Clínica, Ultra y Enterprise.

Siguiente →

Autenticación