Authentication
Every request to RouteCloud must be authenticated. Use your Verizon Connect Enterprise username and password to authenticate with the RouteCloud API. To get a username and password, contact Verizon Connect sales.
Basic Authentication
For convenience, authentication can be done on every request with Basic Auth.
Verizon Connect usernames contain a colon (:
), which must be url-encoded as %3A
. For example:
curl -u "youraccount%3Amain:password" "https://routecloud.telogis.com/v1/build" -H "Content-Type: application/json" --data-binary "@multiday.json"
Using the Verizon Connect Authentication Service
The most secure way to authenticate is to make a separate POST call to the Verizon Connect authentication service, then pass your session ID into RouteCloud API calls as a header.
To get a session ID from the Verizon Connect authentication service:
curl "https://login.telogis.com/login" -H "Content-Type: application/json" --data-ascii '{"username":"youraccount:main", "password":"pass123", "application":"session"}'
Example result from Verizon Connect authentication service:
{"success":true,"sessionId":"e938d41c-d519-4f07-b0a9-26d4745d6e74"}
Example call to RouteCloud API with the session ID:
curl "https://routecloud.telogis.com/v1/build" -H "Content-Type: application/json" -H "X-Telogis-Session-Id: e938d41c-d519-4f07-b0a9-26d4745d6e74" --data-binary "@multiday.json"
Session Lifetime
A Verizon Connect authentication session times out after approximately one hour of non-usage. Every call that uses the session ID extends the lifetime of the session.