Spanish

General RapidSOS

¿Qué es the RapidSOS Developer Portal?

  • The RapidSOS Developer portal provides guidance, resources, and available SDKs and API documentation to assist in implementing RapidSOS solutions into your application.

¿Quién usa los APIs on the RapidSOS Developer Portal?

  • Typically, two types of groups utilize our APIs. These tend to include:
    • Public Safety Integrations - Those that need to receive emergency related information (such as ECCs, PSAPs, etc.)
    • Tech Partners - Those that need to send emergency related information (such as Apple, Google, etc.)
  • If you fit into one (or both) of these categories, you are likely eligible to register for an account.

¿Que hago para empezar?

  • Para usar nuestros APIs, you need to have a developer account and an authentication token/keys. You can register an account by emailing [email protected] if you are a Public Safety Partner or [email protected] if you are a Tech Partner.

After submitting, RapidSOS will send you an email with instructions to get started.

Check the Getting Started page for further instructions and to learn how to get an authentication token.

¿Qué es OAuth 2.0?

Connectivity

¿Qué directiva de conectividad existe?

  • El NG911 Clearinghouse se puede consultar (ya sea a través de las API de REST, las interfaces NG911, o de otro modo - las reglas son siempre las mismas) a través de redes públicas sólo cuando se usa TLS junto con claves de API estrechamente controladas - el acceso es limitado y supervisado por velocidad, y las claves de acceso de producción se conceden sólo al personal autorizado con una cadena de custodia documentada de credenciales de producción. Las conexiones siempre deben ser "entrantes" a nuestro sistema como solicitudes HTTPS estándar a través del puerto TCP 443. El centro de intercambio nunca realizará conexiones "salientes" a ningún sistema gubernamental, excepto para responder a las consultas.
  • Gran parte de los detalles están documentados aquí. Este portal para desarrolladores también es el mecanismo por el que se administran las claves de API, como se documenta. Una vez que las llaves están en manos del personal autorizado, la seguridad de esas llaves es su responsabilidad. Si alguna vez se detecta un abuso (grandes volúmenes de tráfico de spam, actividad de consulta anómala similar a la exploración de números, etc.), el acceso a las API puede limitarse o suspenderse para proteger la integridad y la seguridad del sistema por clave de API. No se permitirá ningún tráfico no autenticado a través del sistema de producción, es decir, se deben usar claves de API válidas para todas las solicitudes. De forma predeterminada, cada conjunto de claves de API está limitado a 1000 solicitudes por minuto.
  • Las modificaciones a los valores de los parámetros son posibles para las interconexiones de red personalizadas (por ejemplo, para un gran número de estaciones de toma de llamadas o PSAP, los límites de velocidad se pueden establecer más altos). Sin embargo, para configuraciones de gran volumen, se recomienda mantener más de un conjunto de credenciales de API por sitio.

Can a VPN be used for integration?

  • If a VPN is required for integration, RapidSOS utilizes an AWS VPN with a network proxy. Partners must provide internal IP address.

Is an internet connection required for integrations?

  • Yes. Internet connection is required for all of our integrations. If no internet access, the partner will need to create a proxy server and whitelist URLs.

Data

¿ Puede el origen de un incidente ser un texto o una llamada?

  • Sí. El origen, ya sea un texto o una llamada, puede mostrarse.

Public Safety Partners

API Behavior

¿Hay una API de RapidSOS que nos dirá si una coordenada GPS cae dentro/fuera de la geocerca de las claves de API actuales?

  • No. Esto no está disponible en este momento. Es probable que se presente un error 400.

¿Funciona la función de llamada de emergencia fuera de los EE. UU.?

  • Los números de teléfono pueden funcionar, pero los datos se enviarán solamente en los países actualmente activos. Consulte los países disponibles.

Is a .NET client layer provided for APIs?

  • RapidSOS does not provide a .NET client layer for public safety integration APIs.

Location Data

¿Cuántas ubicaciones de carga útil se proporcionan para texto a 911?

  • RapidSOS obtiene 1 carga útil de ubicación por mensaje para texto a 911.

¿Se pueden recibir las ubicaciones si los servicios de ubicación están deshabilitados en el dispositivo?

  • Cuando se realiza una llamada al 911, recibimos la ubicación incluso si una persona tiene sus servicios de ubicación apagados.

¿ RapidSOS proporciona datos de ubicación para teléfonos fijos?

  • No. RapidSOS solo proporciona datos de ubicación para dispositivos móviles.

¿ Funciona la solución de ubicación RapidSOS en dispositivos más antiguos?

  • Soluciones de ubicación disponibles por el soporte de RapidSOS:

    • iOS 12 y superior
    • Android 4.0 y superior

  • Nota: Los dispositivos Microsoft y Blackberry no son compatibles actualmente.

¿Se puede rastrear las ubicaciones sin conexión a Internet?

  • Se requiere conectividad a Internet para realizar un seguimiento de la ubicación.
  • Sin embargo en países como México tenemos un desarrollo propio de SMS binario en cual con la mínima señal GSM enviarán los datos a los PSAPss

¿ Alguna API de RapidSOS proporciona una coordenada Z para la altitud?

  • Sí. La API de IPJ puede proporcionar una coordenada Z para la altitud. LEI API

Integration Process

What is the integration process with RapidSOS for a Public Safety Partner?
Refer to this page for specific details. A summary of the steps involved are:

  1. Partner Signs NDA
  2. Partner has introductory call with RapidSOS Partner team to discuss how RapidSOS can fit into Partner’s product
  3. Partner reviews RapidSOS Developer Portal for technical details on offerings
  4. Partner and RapidSOS team meet again for technical deep dive
  5. Partner fills out Partner SignUp Form and Sandbox Credential Request Form
  6. RapidSOS Engineer provides Partner Sandbox credentials to begin testing
  7. Partner develops and has check-ins with RapidSOS team to ensure correct direction and base requirements are met
  8. Once Partner is satisfied with integration, Partner submits integration approval form for RapidSOS team to review
  9. RapidSOS reviews submission from Partner and schedules call between both parties to discuss
  10. If requirements not met, Partner makes changes and re-submits approval
  11. If requirements are met, integration is approved and RapidSOS will notify Partner when they can begin implementing the integration at mutual ECCs

PSAP (ECC) Configuration

¿Cuáles son las reglas del cortafuegos?

  • Desde la perspectiva de las redes gubernamentales, los firewalls solo necesitan admitir solicitudes HTTPS salientes a través del puerto TCP 443 y permitir sus respuestas (a través de reglas de inspección con estado o de otro modo). Además, cuando el tráfico va a pasar por redes públicas, se debe admitir la resolución DNS (utilizamos DNS como una capa de nuestra configuración de alta disponibilidad).
  • Desde la perspectiva de la red de centro de compensación RapidSOS, limitamos de manera similar el tráfico entrante de las redes públicas al puerto TCP 443.

¿Se pueden utilizar VPN?

  • Para ciertas redes, RapidSOS ya mantiene algunas VPN dedicadas de sitio a sitio IPSec y sería capaz de poner en marcha otras nuevas a petición, siempre y cuando no sea un VPN exótico. La lista de hardware VPN compatible con RapidSOS se puede encontrar here.
  • Hasta ahora RapidSOS ha trabajado siempre con las VPN estáticamente ruteadas, pero debe poder soportar el dynamic Routing BGP también (como se indica en el link antedicho). Para recorrer esta ruta se requeriría coordinación, asignación y programación de recursos técnicos, y por lo tanto no será la opción más rápida disponible para permitir la integración con nuestra red.
  • Observamos que cuando se hace con la configuración de firewall adecuada, en el contexto de las conexiones TLS "solo salientes" originadas localmente no son menos seguras para la red de origen que el uso de una VPN de sitio a sitio.

¿La lista blanca de DNS tiene capacidad disponible o solo está disponible para las IP?

  • RapidSOS confía en DNS para el tráfico a través de redes públicas como parte de nuestras estrategias de alta disponibilidad y escalado automático. Por lo tanto, cuando la lista blanca debe hacerse por dominio (es decir, api.rapidsos.com) - la mayoría de los firewalls modernos lo admiten a través de reglas de inspección con estado estándar.
  • A continuación se muestra una lista de dominios conocidos que han tenido que ser incluidos en la lista blanca para que RapidSOS Portal y varias integraciones funcionen: here

¿Cómo pueden las redes oficiales acceder a las interfaces de datos de RapidSOS Plataforma de datos de respuesta a emergencias?

  • A veces se necesitan consideraciones especiales. En general, RapidSOS se compromete a ser tan flexible como sea necesario para adaptarse a los requisitos de conectividad de cualquier red gubernamental, soporta una variedad de configuraciones.

Tech Partners

Location Data

Supplement (Additional) Data

Si se envía una locación y se envía otra sin datosd, ¿qué sucede?

  • RAPIDSOS lo actualiza a blanco (sin datos), incluso si es un campo opcional.

Requerimientos y Recomendaciones para Public Safety

Requerimientos para las integraciones

  • Los datos se proporcionan a la entidad 9-1-1 que responde la llamada únicamente (no debe ser utilizada por socios de integración para fines comerciales u otros).
  • Cada entidad 9-1-1 necesita tener credenciales de acceso únicas al sistema RapidSOS. Cada agencia acepta el acuerdo de licencia para cada credencial de integración que soliciten. RapidSOS gestiona este proceso.
  • A partir del 20/02/2020, la gestión de credenciales se gestiona a través del módulo administrativo dentro del portal RapidSOS.
  • Los socios de integración no tienen acceso al entorno de producción. Los socios de integración tienen acceso a pruebas / desarrollo solo en el entorno de RapidSOS Sandbox o de preproducción.
  • Los datos deben mostrarse como datos complementarios (es decir, además de los datos regulados, no reemplazar los datos regulados). Los datos RapidSOS nunca deben reemplazar los datos regulados por la organización federal de su país.
  • Al conectarse a la conexión de Clearinghouse, debe usar TLS v1.2 o superior.
  • Se requiere consultar todas las llamadas. Las integraciones no deben analizar la conexión inalámbrica, por parte del operador, ni excluir las llamadas consultadas.
  • Se requiere consultar automáticamente. Los datos deben consultarse automáticamente y no requieren la interacción del usuario para invocar el proceso de consulta inicial.
  • Los datos de ubicación de RapidSOS no deben actualizar la llamada para la ubicación del servicio automáticamente. Se debe proporcionar un mecanismo para actualizar la ubicación del servicio mediante programación (por ejemplo, presionar un botón) con los datos de RapidSOS para que los usuarios finales puedan tomar esta decisión y actualizar rápidamente el registro de llamadas si lo desean.

Características Requeridas

  • Mostrar coordenadas X, Y en formato de texto.
  • Mostrar ubicación en el mapa (cuando se incluye un mapa en la solución) usando íconos que diferencian la ubicación ALI frente a RapidSOS
  • Hay Activos (logos) de marca RapidSOS que pueden usarse para la implementación aquí.
  • Incluya el círculo de radio de confianza o certeza como un campo de texto si lo prefiere.
  • Etiquete claramente la ubicación de RapidSOS separada de la ubicación de ALI. Se recomienda utilizar el logotipo de RapidSOS que se encuentra en la sección de Activos de marca RapidSOS de este portal de desarrollo.
  • Mostrar la relación con los datos de ALI (por ejemplo, como superposiciones en la misma pantalla con una línea trazada entre ALI y la ubicación de RapidSOS)
  • Incluya datos adicionales (no solo la ubicación), ya sea a través de una integración API o mediante la integración del portal RapidSOS.

Mejores practicas de integración

A continuación, compartimos algunas de las mejores prácticas para que usted considere al desarrollar una integración entre RapidSOS Clearinghouse y su producto. Nuestra intención no es decirle qué hacer con su producto, sino compartir lo que hemos aprendido después de trabajar con muchos socios en integraciones, y de cerca con más de 4700 agencias de 911 a diario. Nuestro objetivo es garantizar el más alto nivel de satisfacción del cliente para todos nosotros. También nos complace discutir esto con usted mientras planifica su diseño de integración.

Características recomendadas

  • Mostrar ubicación en un mapa con radio de incertidumbre y como texto con información adicional (por ejemplo, marca de tiempo, lat / long, altitud, etc.). Diseñe la pantalla de modo que sea fácil relacionar los datos de ubicación de diferentes fuentes (por ejemplo, superposiciones, una al lado de la otra, etc.). NOTA: A partir de septiembre de 2018, este es un requisito para nuevas integraciones, como se señaló anteriormente. Las integraciones existentes deberían agregar esta capacidad en su próximo ciclo de desarrollo. Los iconos deben diferenciar claramente la ubicación de ALI y RapidSOS.
  • Mostrar la ubicación como x / y / z con la capacidad de revertir el geocodificación utilizando datos ECC autorizados.
  • La geocodificación inversa no es proporcionada por RapidSOS y debería integrarse en una integración por separado. (traducción x / y / z en dirección, numero, colonia, etc.)
  • Mostrar seguimiento de ruta cuando la persona que llama se está moviendo
  • Habilite una función de "alternar" para apagar el círculo y / o movimiento de la llamada si interfieren con la vista de la pantalla del operador.
  • Permita que la ubicación se almacene como parte del registro de llamadas / incidentes.
  • Habilite la ubicación para que se envíe a aplicaciones de terceros (por ejemplo, Mapa, CAD, aplicación de respuesta, grabación, etc.)
  • Consultar ubicación y datos adicionales periódicamente a lo largo de la llamada (el intervalo típico sería cada 7-10 segundos). Las integraciones más sofisticadas varían el intervalo de consulta en función del origen de los datos y el tiempo desde que los datos han cambiado. Esto es importante si una persona que llama se está moviendo o si hay datos adicionales disponibles, y aumenta en importancia a medida que se agregan más conjuntos de datos al Centro de Información.
  • Sobre la base de lo anterior, permitir a los usuarios "breadcrumb" sin desordenar la interfaz principal del mapa (permitir a los usuarios "activar / desactivar" los puntos de ubicación es una excelente manera de gestionar esto). Es importante ver hacia dónde se mueve la persona que llama, pero esto no debería interferir con otros datos importantes.
  • Mostrar datos adicionales (es decir, de la API de datos adicionales o del portal RapidSOS integrado) en una pestaña separada donde no distraiga al usuario cuando sea irrelevante. Sin embargo, proporcione algún indicador en la pantalla principal de que hay datos adicionales disponibles. Los ejemplos pueden ser cuando se pasa el cursor por encima, o se "ilumina" el icono en un color diferente, o algún otro indicador apropiado que sea informativo pero no distraiga.
  • Permita que el Telecomunicador copie la ubicación y los datos adicionales que están en formato de texto para pegarlos o ingresarlos en su incidente CAD, si no hay un mecanismo para hacerlo automáticamente. Se prefiere que lo haga automáticamente.
  • Si se trata de una integración CAD, permita que el Telecomunicador use la ubicación de RapidSOS para actualizar la ubicación del evento con un simple clic en el botón.
  • Integración CAD: para una experiencia de usuario óptima, considere proporcionar un método para que los datos, como la matrícula del vehículo, se analicen en los campos CAD que realizarían una consulta automática contra un sistema de estado o NCIC para verificar rápidamente cualquier "acierto".