Smart911Connect allows disparate sources to provide data to 9-1-1 concurrent with an event (emergency call for service processed by a PSAP). As such, a content provider will need expose an API to Smart911Connect in order for the platform to “pull” data when a triggering event is identified at a PSAP. Once approved, content providers supply an API key to Smart911Connect along with a URI and the required parameter types. Smart911Connect technical support will assist you in setting up a connector to point to your service.
There are a couple of things you need to know before you start developing your integration with Smart911Connect.
1. Determine data to expose and query parameters
You should determine which bits of data you wish to expose to 9-1-1. Also, you should determine the what type of input parameter you need from Smart911Connect to lookup your data (e.g. address, phone number, special field contained in the ALI, combination parameters, etc).
2. Setup your connector with Smart911Connect
Below is a list of items that will be needed to setup a connector in Smart911Connect. After you register, technical support will contact and need the following:
Here’s an example of an API request to your service:
URI Format: HTTP GET https://api.myemergencydatasource.com/v1/data/method?apikey=:yourkey&ani=5082223333
In order for the platform to respond quickly to a 9-1-1 event, a registry may be used to store key data points for lookup purposes. This registry will be populated via a secure REST request with data points such as an ANI (unique phone number), or address and a URI mapping. The URI will be used to retrieve details related to the call if a match in the registry exists. The Registry may also be populated via an offline, batch interface.
There may be some providers who may need to a custom input parameter to be used for a lookup. In that case, a premium level will be made available to the provider. The provider will work with the Smart911Connect engineering team to determine the best approach for capturing that data point and making it available.
Retrieval of additional data
Smart911Connect will fetch details from content providers via the exposed URI. Depending on the integration this may occur after a match is made in the registry, or directly with all calls meeting defined criteria. A secure REST request will made via the URI to the provider. The provider will respond with data formatted in JSON. Smart911Connect will format the data and deliver to the answering operator.
The premium level allows for other parameters to be used besides the ANI.
A third party may choose to consume the data aggregated by Smart911Connect. There are two ways a third party may consume this service. The third party may choose to be served up an HTML formatted response to be intergrated into a browser. Or, a third party may want a “raw” JSON response that can be consumed in any way.
On both of the above types, a secure REST request will be sent to Smart911Connect with a parameter(s) such as an ANI. Based on the preference of the third party, the response will be either HTML or JSON.