Authentication
Every request to RouteCloud must be authenticated. You may use Verizon Connect Reveal or Fleet credentials to access the RouteCloud API. If you do not already have an account, contact Verizon Connect sales.
Basic Authentication
HTTP Basic Authentication is supported for both Verizon Connect Reveal and Fleet accounts.
curl -u "user@domain.com:password" "https://routecloud.telogis.com/v1/build" -H "Content-Type: application/json" --data-binary "@multiday.json"
Verizon Connect Fleet 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"
If your client supports cookies a session token will be set in the response, your client will still need to handle re-authenticating on session expiry.
Verizon Connect Reveal JWT Authentication
JWT Bearer authentication is supported for Reveal
curl -H "Authorization: Bearer {JWT}" "https://routecloud.telogis.com/v1/build" -H "Content-Type: application/json" --data-binary "@multiday.json"
Verizon Connect Fleet Session ID Authentication
To get a session ID from the Fleet authentication service:
curl "https://login.telogis.com/login" -H "Content-Type: application/json" --data-ascii '{"username":"youraccount:main", "password":"pass123", "application":"session"}'
Example result:
{"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 Fleet authentication session times out after approximately one hour of non-usage. Every call that uses the session ID extends the lifetime of the session.