Skip to content

Authentication

This document covers details of the EventHub Application Programing Interface (API) to publish/subscribe events from/to Telenav Cloud. This API uses HTTP 1.1 protocol, and the entire HTTP body is in JSON (Java Script Object Notation) data format.

Cloud Endpoint：https://restapistage.telenav.com

Authentication

To use EventHub API, client application should provide an API Key and an API Signature.

Specify api key in your request by including it as the value of the x-tn-api_key header and specify api signature in your request by including it as the value of the x-tn-api_signature header.

Signature Generation

The API Signature is unique per request. You can create a valid API signature for your request as follows:
api­key + “:” + timestamp + “:” + MD5 (api­key + “:” + timestamp + “:” + api­secret) where timestamp is the value of UTC in seconds, such as 1393379693.

A sample Postman Pre-request script that shows how to generate these values is below

1
2
3
4
5
6
7
8
var apiKey = // <Provided API Key>
var apiSecret = // <Provided API Secret>
var timestamp = Math.round(new Date().getTime() / 1000);
var signature = apiKey + ':' + t + ':' + CryptoJS.MD5(apiKey + ':' + timestamp + ':' + apiSecret).toString();

// Use these environment in the Request Headers: x-tn-api_key and x-tn-api_signature
postman.setEnvironmentVariable("api_key", apiKey);
postman.setEnvironmentVariable('api_signature', signature);

Refer to Publish Events sections for details.