...
These services should be integrated in your user registration process, so that you ensure that all your user accounts have a corresponding Bokskya account.
Validate account
...
Validate state for a Bokskya account by ddsId or email.
URL | |||
Method | GET | ||
Request headers | Authorization | Required | The token acquired from the Authentication Service. Formated "Boknett TGT-...." |
Date | Required | The 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 | {"email": "ola.nordmann@norge.no", "name": "Ola", "surname": "Nordmann",} | ||
Returns | 200 | OK | |
400 | Bad Request | ||
401 | Unauthorized | ||
403 | Forbidden | ||
404 | Not found (returned if the requested user is not found) | ||
406 | Not Acceptable | ||
500 | Internal Server Error |
...
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 {"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 {"data":"USER_NOT_FOUND"} |
Register Account
Create a new DDS user account for bokskya.
URL | https://idp.dds.boknett.no/register
| ||
Method | POST | ||
Request headers | Authorization | Required | The token acquired from the Authentication Service. Formated "Boknett TGT-...." |
Date | Required | The 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 | { "email": "ola.nordmann@norge.no", "name": "Ola", "surname": "Nordmann", } | ||
Returns | 200 | OK | |
400 | Bad Request | ||
401 | Unauthorized | ||
403 | Forbidden | ||
406 | Not Acceptable | ||
500 | Internal Server Error |
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 {"id":"212c60f9-57db-4b5b-b32a-ed561346eda1","active":true} |