Preguntas frecuentes

Acceso y entornos

¿Cómo consigo una clave?

Pídela al equipo técnico (info@saludenruta.es). Primero te damos una clave de pruebas (srd_test_…) y, cuando validamos la integración contigo, la de producción. Ver primeros pasos.

¿Tiene coste el sandbox?

No. En el sandbox no se factura nada y puedes crear todos los avisos que quieras (dentro de tu límite de peticiones).

¿Por qué el serviceTypeId que uso en pruebas no funciona en producción?

Porque son bases de datos distintas y los id no coinciden. Usa serviceTypeCode, que es igual en los dos entornos. Ver entornos.

Recibo 401 con una clave que acabo de copiar.

Comprueba: que va en la cabecera X-Api-Key (no en la URL ni como Bearer), que la has copiado entera, y que usas la clave del entorno correcto (srd_test_ con el sandbox, srd_live_ con producción). Si el type es wrong-environment, es lo último. Si todo cuadra, escríbenos con el prefijo de la clave.

¿Puedo llamar a la API desde el navegador o desde una app móvil?

No. La clave es secreta y daría acceso a los avisos de tu organización a cualquiera que la extrajera. Las llamadas se hacen siempre desde tu servidor. Ver buenas prácticas.

Avisos

¿Puedo modificar un aviso ya creado?

No por la API. Si el aviso aún se puede cancelar, cancélalo y crea otro con los datos correctos. Si no, o si es un cambio menor (un teléfono, una indicación de acceso), llama a la centralita (+34 611 673 280).

¿Por qué no puedo cancelar un aviso?

Porque la unidad ya ha salido (EN_ROUTE) o está en el domicilio (ON_SITE), o el aviso ya terminó. Por la API solo se cancelan avisos PENDING o ASSIGNED; en los demás casos hay que llamar a la centralita. Ver cancelar.

¿Cuánto tarda en llegar la unidad?

Depende de la prioridad, la zona y la carga del momento. Para un aviso concreto, cuando la unidad está en camino, GET /visits/{id}/eta te da la hora estimada.

¿Atendéis emergencias?

No. Salud en Ruta atiende urgencias no vitales a domicilio. Ante una emergencia vital, el paciente debe llamar al 112. No envíes por la API avisos que requieran una ambulancia.

¿Puedo enviar avisos para cualquier dirección?

La cobertura es Madrid capital y la Comunidad de Madrid. Si tienes dudas sobre una zona, pregúntanos.

¿Qué pasa si envío un aviso con un DNI que ya existe con otro nombre?

El aviso se crea con normalidad y en las respuestas verás el nombre que enviaste. Internamente, la centralita revisa el emparejamiento. Ver pacientes y privacidad.

¿Cómo busco un aviso si no guardé su id?

Por tu nº de expediente: GET /visits?externalRef=EXP-2026-004512. Por eso recomendamos enviarlo siempre.

Webhooks

No me llegan los webhooks.

Comprueba que tu URL es HTTPS pública (no localhost ni una IP interna), que no redirige, que el certificado es válido y que respondes 2xx en menos de 10 segundos. Pídenos un webhook.test y te diremos qué respuesta recibimos de tu servidor. Ver probar tu receptor.

La firma nunca me cuadra.

Casi siempre es porque se calcula sobre el cuerpo ya convertido a objeto y vuelto a serializar. Usa el cuerpo crudo, tal y como llega (en Express, express.raw(); en Flask, request.get_data(); en PHP, php://input). Comprueba también que usas el secreto completo, con whsec_, y prueba tu función con el caso de ejemplo.

Recibo el mismo evento dos veces.

Es normal: los reintentos garantizan que no pierdes eventos, a cambio de que alguno llegue repetido. Descarta los duplicados por el id del evento. Ver idempotencia del receptor.

Los eventos me llegan desordenados.

También puede pasar con los reintentos. Usa data.visit.status y los milestones para saber en qué punto está el aviso, en vez del orden de llegada.

Informes y datos

¿Por qué no puedo descargar el informe?

Porque aún no está firmado o compartido, o porque el paciente no ha consentido que se te envíe. Sin consentimiento no hay informe. Ver informe asistencial.

¿Puedo obtener el diagnóstico o el tratamiento por la API?

Solo a través del informe asistencial, con el consentimiento del paciente. La API no devuelve datos clínicos sueltos. Ver qué no devolvemos nunca.

¿Hay una librería oficial (SDK)?

De momento no. La API es REST sencilla y tienes ejemplos en seis lenguajes; además, con el openapi.json puedes generar un cliente para tu lenguaje con OpenAPI Generator.