Referencia de endpoints

Todos los endpoints REST de la API v1

Referencia completa de cada endpoint disponible en la API v1. URL base: https://cbcthub.com/api/v1

GET/api/v1/me

Devuelve info de tu cuenta (plan, storage, exam count). Útil para verificar que la key funciona.

json

{
  "user_id": "...",
  "email": "soporte@miclinica.com",
  "plan": "pro",
  "scopes": ["exams:read", "exams:write"],
  "storage": { "used_bytes": 41200000000, "limit_bytes": 375809638400, "used_percent": 11 },
  "exams": { "count": 110, "limit": 999999 }
}

POST/api/v1/exams

Crea un examen y devuelve URLs presignadas para upload directo a R2.

Campo	Tipo	Requerido	Notas
name	string	✓	Nombre interno del examen (máx 200 chars).
exam_type	string	—	cbct (default), radiografia, mesh, atm. Radiografia requiere Pro.
patient_name	string	—	Nombre del paciente. Aparece en el visor.
patient_id	string	—	RUT, CPF, historia clínica.
birth_date	string ISO	—	YYYY-MM-DD.
reason	string	—	Motivo / hallazgos solicitados.
expiration_days	number	—	Días hasta expirar. null = nunca.
files	array	✓	[{ name, size }]. Mínimo 1, máximo 5000.

GET/api/v1/exams?limit=20&offset=0

Lista exámenes de tu cuenta, paginado. Default limit=20, máximo 100.

GET/api/v1/exams/{id}

Detalle de un examen. Incluye share_url, viewer_url, share_password y public_page_pin.

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

Marca el examen como ready después de subir los archivos. Idempotente.

DELETE/api/v1/exams/{id}

Elimina el examen. Los archivos en R2 se borran en background. Operación no reversible.

← Anterior

Flujo de subida

Manejo de errores