LoginV3

Content

1 Setup
2 Environments / endpoints
3 Making a request
4 Response

Setup

This is the documentation of how to obtain an authentication token for the ws.di.no domain.

In order to POST data into the API use a JSON object without name.

The token is validity can be specified in the url in minutes, valid values are between 1 and 1440 minutes
The token is returned in a json structure with token as key ( https://jwt.io/ ) and can be handled as a plain string on the client side
New token should be obtained after expiry by calling this endpoint again, not each time another endpoint/service is used

Environments / endpoints

TEST	POST	`https://staging-ws.di.no/ws/json/auth/v-3/login/{minutesValid}`
PRODUCTION	POST	`https://ws.di.no/ws/json/auth/v-3/login/{minutesValid}`

Making a request

Request headers

Key	Value

Key	Value
Content-Type	application/json

Request body

Field	Description	Example	Data type

Field	Description	Example	Data type
username	The username that was provided by the DI service desk	myName	String
password	The password that was provided by the DI service desk	secret!23	String
MinutesValid	Values are between 1 and 1440 minutes which indicates the tome the Token is valid	1440	String

Curl request example

curl -X POST \
  https://ws.di.no/ws/json/auth/v-3/login/1440 \
  -H 'Content-Type: application/json' \
  -d "{\"username\": \"myname\", \"password\": \"secret\"}"

Response

The endpoint replies with a response object in JSON format, containing the following data

Field	Description	Example	Data type

Field	Description	Example	Data type
token	The JWT token to be used in subsequent requests	aVeryLongString	String

The security token should be placed in the Authorization header like this:

"Authorization: Bearer <token>"