Skip to content

Authentication

Authentication is required to use the API interface functions.

The authentication is done with JWT (JSON Web Token, https://en.wikipedia.org/wiki/JSON_Web_Token). By specifying a user name (your mail address) and a password, you request a token via the authorize interface, which is used in further requests. The tokens are valid for 4 weeks. At the latest after expiration of the validity a new token must be requested.ein Token an, das in den weiteren Requests verwendet wird.

The user accounts are managed in MapTrip Manager. If you do not have an account yet, please contact our sales department via eMail : info@infoware.de. In the following we assume that you have a valid username and password.

The token in the requests is specified in the form "Authorization: Bearer [token]".

Token request

authenticate interface

The default case will be that a token is needed for commands from within your own (server) applications.

Request

POST /authenticate

Example curl command

curl -X POST "https://api.maptrip.de/v1/authenticate" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"password\": \"myPassword\", \"user\": \"user@company.com\"}"

Response

1
2
3
{
  "token": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJnb2xkYmFjaEBpbmZvd2FyZS5kZSIsImF1dGgiOiJST0xFX1JPT1QiLCJpZCI6MjYzMDQsImV4cCI6MTYzMTk3NjQzM30.nbU24qeOu35xE2rhyCDv3woTpGAUTdGVXkZPod0ixLbOObLVwIxYMiFsZ2NAjmGGfuotYqUy4_0nj9Nq5EYisw"
}

In the web interface

For a simplified introduction to the MapTrip Server API the API web page offers the possibility to request a token directly. Click on the Button Authorize in the upper right corner and enter the value Bearer followed by the received token (e.g. Bearer eyJhbGciiJ9.eyJ_-wRHLP5cwBlXs7). After clicking Authorize, the token is automatically sent with all subsequent requests.

Use per curl

curl commands allow the use of HTTP headers by specifying the -H parameter. Multiple headers are allowed by specifying the parameter more than once. You pass the token accordingly in the command via -H "Authorization: Bearer ".

Example curl-command

curl -X GET "https://api.maptrip.de/v1/geocoder?provider=TomTom&address=Berlin&country=DEU&limit=1" -H "accept: application/json" -H "Authorization: Bearer eyJhbGciiJ9.eyJ_-wRHLP5cwBlXs7"

Use from within an application

As in the curl command, the token must be sent with every HTTP call. The passing of the parameters and the HTTP header Authorization "Bearer " are of course dependent on the programming language used.