Harsh Braking

Prerequisites

An active account either with  " Freemium " subscription (number of requests is limited to 5), or a  " Business " subscription to the selected service.

Use of the APIs

The use of all our APIs is subject to the use of a user token. To obtain this token, it is necessary to authenticate by an API call.

The authentication allows to get the user token which will be requested in all the API calls.

The url to use: https://api.ddi.michelin.com/ddi/auth/token

Input parameters:

• grant_type: Type of grant. The only accepted value is “client_credentials”.
• client_id: Your customer id. You can find it in your account page (sample: zbQZOqNEAlKuL[…truncated sample..]0K07AyOk).
• client_secret: Your secret password. You can find it in your account page (sample: BZGn8fZu[…truncated sample…]).

Sample using Curl:

curl –-location --request POST 'https://api.ddi.michelin.com/ddi/auth/token'\

--header 'Content-Type: application/x-www-form-urlencoded'\

--header 'Accept: application/json'\

--data-raw 'grant_type=client_credentials&client_id= zbQZOqNEAlKuL[…truncated sample..]0K07AyOk&client_secret= BZGn8fZufqXXXXXX'

Then, the token must be added in the header of the request:

curl --location --request GET 'https://api.ddi.michelin.com/risky_turns/turns?distance=1&long=3.05167&lat=45.9153'\

--header 'Accept: application/json'\

--header 'Content-Type: application/json'\

--header 'Authorization: Bearer eyJraWQiOiJxMXl2M[…truncated sample…] EnWxN67fggh1Q'

Sample using Swagger:

1. Select POST /ddi/auth/token and click on “Try it out”

2. Fill in the input parameters specified above

3. Execute to get your token within the response as below:

{

"token": "eyJraWQxMXl2[…truncated sample…]nWxN67fggh1Q"

}

4. Select the “Authorize” button on the top right corner of the Swagger:

5. Copy and paste the token in the field before validating.

The token will then be automatically used in all API requests.

We recommend you to use the paths below for the first tests:

Authorized parameters using Freemium access

countryCode = US

stateCode = UT

cityCode = 84044, 84108, 84119, 84116, 84109

periodStart = 2020_01

periodEnd = 2020_01