Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL

https://idp.dds.boknett.no/validate/{ddsid}

 https://idp.dds.boknett.no/validate/{email}

MethodGET
Request
headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
Response
body on success
{
  "id": "ola.nordmann@norge.no",
  "active": "Ola",
  "surname": "Nordmann",
}
Returns200OK (Will also be returned if user not found, see response body)
400Bad Request
401Unauthorized
403Forbidden
406Not Acceptable
500Internal Server Error

 

Curl examples

Example of successful response based on email address:

 

curl -i -H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" -H "Date: Thu, 13 Aug 2015 12:16:39 GMT" 'https://idp.dds.boknett.no/validate/ola.nordmann@norge.no'
HTTP/1.1 200 OK
Content-Length: 59

{"id":"212c60f9-57db-4b5b-b32a-ed561346eda1","active":true}

 

Example of request where user does not exist:

curl -i -H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" -H "Date: Thu, 13 Aug 2015 12:16:39 GMT" 'https://idp.dds.boknett.no/validate/kari.nordmann@norge.no'
HTTP/1.1 200 OK
Date: Thu, 13 Aug 2015 12:24:30 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 25

{"data":"USER_NOT_FOUND"}

 

 

Register Account

Create a new DDS Bokskya user account

 

URLhttps://idp.dds.boknett.no/register
MethodPOST
Request
headers

Authorization

Required

The token acquired from the Authentication Service.

Formated "Boknett TGT-...."

DateRequiredThe timestamp the request was made. Must comply with RFC 1123 date formats. Example: Tue, 10 Jun 2014 16:23:42 GMT
JSON attributesemailRequiredEmail of the user (unique in bokskya)
nameRequiredFirst name of the user
surnameRequiredSurname of the user
Response
body
{"id":"743a3b25-e71f-4544-82c7-b5e66358b08a","active":true}
Returns200OK
400Bad Request
401Unauthorized
403Forbidden
406Not Acceptable
500Internal Server Error


 

Curl example 

Example of successful creation of user:

$curl -i -H "Content-Type: application/json" -H "Authorization: Boknett TGT-29061-mbdeGwDnbGTJ4qlSv4IYTm5Cpu5iDO1XxOSgg2IPAXNPhGEa0v-login.boknett.no" -H "Date: Thu, 13 Aug 2015 14:40:00 GMT" -d '{"email":"ola.nordmann@norge.no","name":"Ola","surname":"Nordmann"}' "https://idp.dds.boknett.no/register"
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{"id":"743a3b25-e71f-4544-82c7-b5e66358b08a","active":true}

 

...