...
These services should be integrated in your user registration process, so that you ensure that all your user accounts have a corresponding Bokskya account.
| Info |
|---|
New Authentication & URLs introduced Q2 2024 |
Validate account
Validate state for a Bokskya account by ddsId or email.
URL |
| ||
...
| |||||||
Method
GETRequest
headers
Authorization
Required
| |||
| |||
Required
| |||||
Method |
| ||||
Request | Authorization | Required | The token acquired from the Authentication Service. Audience: | ||
Accept | Required | application/json (We recommend all new implementations to use this header, XML support will be phased out in the future) | |||
Response |
| ||||
Returns |
| OK (Will also be returned if user not found, see response body) | |||
| On error | ||||
Curl examples
Example of successful response based on email address:
| Code Block | ||
|---|---|---|
| ||
curl -i -H "Accept: application/json" \
-H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" \
-H "Date: Thu, 13 Aug 2015 12:16:39 GMTBearer <token>" \
'https://idpapi.dds.boknett.no/validatebokbasen.io/bokskya/account/v1/ola.nordmann@norge.no'
HTTP/1.1 200 OK
Content-Length: 59
{"id":"212c60f9-57db-4b5b-b32a-ed561346eda1","active":true} |
...
| Code Block | ||
|---|---|---|
| ||
curl -i -H "Accept: application/json" \
-H "Authorization: Boknett TGT-28905-pOzdvVr50wpTMl10DooFrDjTarMdwkeRzhlJ4KcMrQfEl13fxK-login.boknett.no" \
-H "Date: Thu, 13 Aug 2015 12:16:39 GMTBearer <token>" \
'https://idpapi.dds.boknett.no/validatebokbasen.io/bokskya/account/v1/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"} |
...
Create a new DDS Bokskya user account
URL |
| |||||||
Method
POST
Request
headers
Authorization
Required
| |||
| |||
Required
| |||
| |||||
Method |
| ||||
Request | Authorization | Required | The token acquired from the Authentication Service. Audience: | ||
Accept | Required | application/json (We recommend all new implementations to use this header, XML support will be phased out in the future) | |||
Content-type | Required | application/json | |||
JSON attributes | Required | Email of the user (unique in bokskya) | |||
name | Required | First name of the user (minimum length 2) | |||
surname | Required | Surname of the user (minimum length 2) | |||
Response |
| ||||
Returns |
| OK | |||
| On error | ||||
Curl example
Example of successful creation of user:
| Code Block | ||
|---|---|---|
| ||
$curl -i -H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Boknett TGT-29061-mbdeGwDnbGTJ4qlSv4IYTm5Cpu5iDO1XxOSgg2IPAXNPhGEa0v-login.boknett.no" \
-H "Date: Thu, 13 Aug 2015 14:40:00 GMT" Bearer <token>" \
-d '{"email":"ola.nordmann@norge.no","name":"Ola","surname":"Nordmann"}' \
"https://idpapi.dds.boknett.no/registerbokbasen.io/bokskya/account/v1"
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{"id":"743a3b25-e71f-4544-82c7-b5e66358b08a","active":true} |
Auth user by partner
| Status | ||||
|---|---|---|---|---|
|
Service Service to authenticate a Bokskya account on behalf of a user and to support Bokskya implementation of Adobe Content Server VendorID.
| Expand | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Get adobeId
| Status | ||||
|---|---|---|---|---|
|
Look up AdobeID for a Bokskya account by ddsId or email
| Expand | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||