Versions Compared

Key

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

...

  • (warning) Må bytte:

    • Onix Export API (current URLsnåværende URLer: api.boknett.no/metadata/export/onix/*)

    • Object Export API (current URLsnåværende URLer: api.boknett.no/metadata/export/object/*)

  • Anbefaler å bytte:

    • Digital Distribution System (current URLsnåværende URLer: api.dds.boknett.no/*, idp.dds.boknett.no/*)

    • Order API (currentlynåværende URLer: api.order.boknett.no)

Utgivere og distributører

  • (warning) Må bytte:

    • Onix Import API (currentlynåværende URLer: api.boknett.no/metadata/import/onix/*)

    • Object Import API (currentlynåværende URLer: api.boknett.no/metadata/import/object/*)

...

Audience-value to use with Auth (test-environment), see Use of Audience

metadata

https://api.stage.bokbasen.io/metadata/

dds

https://api.stage.bokbasen.io/dds/

bokskya

https://api.stage.bokbasen.io/bokskya/

orders

https://api.stage.bokbasen.io/orders/

Test Production -vs- productionsTest/stage

  • Login/auth for prod → Remove .stageAudience for prod → Remove .stageapi.bokbasen.io -vs- api.stage.bokbasen.io

  • Audience → api.bokbasen.io -vs- api.stage.bokbasen.io

  • API-endpoints for prod → Remove .stageapi.bokbasen.io -vs- api.stage.bokbasen.io

Endpoints for Retailers

Each API has gotten a new URL. Here you can see a overview of the new URLs as well as the corresponding audience to use.

Auth
Audience

API

Method

New endpoint URL (test-enviroment)

metadata

(warning) ONIX (warning)

GET

https://api.stage.bokbasen.io/metadata/export/onix/v1

(warning) Objects (warning)

GET

https://api.stage.bokbasen.io/metadata/export/object/v1

dds

Inventory

GET

https://api.stage.bokbasen.io/dds/inventory/v2

https://api.stage.bokbasen.io/dds/inventory/v2/{isbn}

Orders and reporting

POST

https://api.stage.bokbasen.io/dds/order/v1

Bokbasen distributes binaries to the end user

POST

https://api.stage.bokbasen.io/dds/order/subscription/v1

Content download

GET

GET

GET

GET

https://api.stage.bokbasen.io/dds/content/v1/{fulfillmentId}

https://api.stage.bokbasen.io/dds/content/v1/raw/{resourceId}

https://api.stage.bokbasen.io/dds/content/v1/library/{resourceId}

https://api.stage.bokbasen.io/dds/content/v1/{resourceId}/sample

bokskya

Bookshelf / OPDS

GET

https://api.stage.bokbasen.io/bokskya/content/v1/{id}

IDM

POST

GET

GET

https://api.stage.bokbasen.io/bokskya/account/v1

https://api.stage.bokbasen.io/bokskya/account/v1/{id}

https://api.stage.bokbasen.io/bokskya/account/v1/{email}

orders

Send Order

POST

https://api.stage.bokbasen.io/orders/v1

Update order line

POST

https://api.stage.bokbasen.io/orders/v1/{id}/update

Update order line status

POST

https://api.stage.bokbasen.io/orders/v1/{id}/lines/{lineId}

Get Order data

GET

GET

GET

https://api.stage.bokbasen.io/orders/v1

https://api.stage.bokbasen.io/orders/v1/{id}

https://api.stage.bokbasen.io/orders/v1/{id}/editx

...

Auth
Audience

API

Method

New endpoint URL (test-environment)

metadata

(warning) Import Service (warning)

POST

GET

GET

POST

https://api.stage.bokbasen.io/metadata/import/onix/v1

https://api.stage.bokbasen.io/metadata/import/onix/v1/status/{id}

https://api.stage.bokbasen.io/metadata/import/onix/v1/status/all

https://api.stage.bokbasen.io/metadata/import/object/v1/{id}/{type}

orders

Get Order data

GET

GET

GET

https://api.stage.bokbasen.io/orders/v1

https://api.stage.bokbasen.io/orders/v1/{id}

https://api.stage.bokbasen.io/orders/v1/{id}/editx

How can I test?

When you have gotten test- credentials (clientId + clientSecret) from Bokbasen.