Integra tus avisos con Salud en Ruta

Qué permite hacer la API de Salud en Ruta, para quién es, cómo es el ciclo de vida de un aviso y qué queda fuera de la integración.

Cómo conseguir acceso a la API y hacer tu primera integración completa en cinco minutos contra el entorno de pruebas: catálogo, alta de un aviso, consulta y primer webhook.

Diferencias entre producción y el entorno de pruebas (sandbox), prefijos de las claves, la cabecera X-Serad-Environment, por qué los identificadores cambian entre entornos y la lista de comprobación para pasar a producción.

Cómo autenticar las llamadas con X-Api-Key, qué permite cada ámbito, cómo se rotan y revocan las claves, buenas prácticas y qué hacer si una clave se filtra.

Qué devuelve GET /catalog — tipos de servicio que puedes pedir y profesional que requiere cada uno, aseguradoras finales para intermediarios y si el nº de expediente es obligatorio — y cómo usarlo.

Crear avisos (todos los campos, prioridades, citas, dirección y paciente), consultarlos, listarlos con filtros y paginación, conocer la hora estimada de llegada, cancelarlos y descargar el informe asistencial.

Cómo identificamos a los pacientes, qué datos suyos devolvemos (solo los que tú enviaste) y cuáles no devolvemos nunca, y cómo se tratan los datos de salud y los informes según el RGPD.

Eventos que te enviamos y cuándo, la carga de cada uno, cómo verificar la firma HMAC-SHA256 en Node.js, Python, PHP, Java y C#, reintentos, deduplicación y cómo probar tu receptor.

Cómo usar la cabecera Idempotency-Key para reintentar el alta de un aviso sin crear duplicados, cuánto dura y qué significan los 409.

Cuántas peticiones por minuto admite cada clave, las cabeceras X-RateLimit, qué pasa al superar el límite (429 y Retry-After) y cómo reintentar bien.

El formato de los errores (RFC 9457), qué significa cada código HTTP y la lista de tipos de error de la API con su causa y su solución.

Cómo funciona el entorno de pruebas, el simulador que hace avanzar los avisos, el modo manual con X-Sandbox-Simulation, los endpoints /sandbox/visits/{id}/advance y /sandbox/reset, y los escenarios de prueba recomendados.

Todos los endpoints, parámetros, cuerpos, respuestas y esquemas de la API v1, generados a partir de su especificación OpenAPI.

Ejemplos listos para copiar en curl, JavaScript/TypeScript, Python, PHP, Java y C# para crear, consultar y cancelar avisos y para verificar los webhooks.

Cómo versionamos la API, qué consideramos un cambio compatible, cómo avisamos de los cambios y el registro de cambios desde la v1.

Respuestas rápidas a las dudas más habituales al integrarse con la API de Salud en Ruta.

Cómo contactar con el equipo técnico de Salud en Ruta para dudas de integración, claves y webhooks, incidencias y avisos urgentes.