Bienvenida a la documentación de TrustCare

Aquí está la documentación técnica que TrustCare comparte con sus socios para integrar sus sistemas con la plataforma.

TrustCare conecta a pacientes con clínicas y especialistas para procedimientos quirúrgicos y acompaña cada caso de punta a punta: valoración, programación, cirugía y post-operatorio. Las clínicas gestionan el caso en el CRM de TrustCare, y los socios reciben y consultan lo que necesitan por API.

Qué encontrarás

Sección	Para qué
Webhooks y datos	Webhook de estado del caso para cualquier socio (HIS de clínicas, aseguradoras), estados del caso y ciclo de vida y tratamiento de los datos.
Integración OSIGU	Guías de la integración con OSIGU: ficha del paciente, catálogo de procedimientos y disponibilidad de agenda.
Referencia de la API	Especificación OpenAPI de cada ruta, con sus parámetros, respuestas y errores. Puedes probarla desde el navegador con un token de stage.

📘
Estado: propuesta (v0.1)
La API para socios está en revisión y todavía no está desplegada. Las rutas y los campos pueden cambiar antes de la v1.

Acceso

Credenciales: TrustCare entrega a cada socio un cliente OAuth2 por entorno, por un canal seguro y nunca en esta documentación.
Entornos: stage (pruebas) y producción. Las URL están en cada guía.
Producción: solo se abre a las IP que el socio indique.

Seguridad en resumen

Transporte: solo HTTPS.
Autenticación: OAuth2 client credentials con alcances mínimos por socio (catalog:read, availability:read, cases:read) y tokens de vida corta.
Webhooks: firmados con HMAC-SHA256 y marca de tiempo contra repeticiones, con secreto propio por socio y rotable.
Datos personales: hoy la API y los webhooks solo comparten datos comerciales del caso (paquete contratado, estado y fecha estimada), sin nombre, documento, contacto ni historia clínica del paciente. Los datos sensibles solo se habilitarán al integrarnos con el HIS de cada clínica, con autorización expresa del paciente (Ley 1581 de 2012). Ver Ciclo de vida y tratamiento de los datos.
Abuso: límite de peticiones por socio (429 con Retry-After).
Trazabilidad: cada llamada de entrada y de salida queda auditada (quién, qué caso, cuándo), sin el contenido de los mensajes.
Aislamiento: los socios solo ven el módulo de integración; los servicios internos de TrustCare no están expuestos.