Revision

DateDescription

 

As of May 17, 2021, CB will no longer support TLS 1.0 and 1.1

 

Initial document

Introduction

This webservice is meant for supporting the process of the publisher regarding (delivering) digital content.

It has the following operations: 

Path: /rest/api/v1/DigitalProductPublisherService

Specific messages (type/code/text) for this webservice:

typeCodeText
IEBS-10038Vitalsource user account unknown

Operation: checkAccess

This operation gives as answer if the supplied Bookshelf/VitalSource user has access to the supplied product (purchased on Bookshelf/VitalSource).
It can be used for example on a publisher website for checking if the user should be granted access to specific digital content that is only available for users who purchased the related product.

Request 

Response

Examples

Situationvalid Bookshelf/VitalSource user and inaccessible product
{
  "EAN": "9789084999912",
   "UserId": "bookshelf@cb-logistics.nl",
  "UserPassword": "bookshelf"
}
{
    "Access": {
        "Accessable": "Y"
    }
}
Situationunknown Bookshelf/VitalSource user

{
  "EAN": "8711000287941",
   "UserId": "bookshelf@cb-logistics.nl",
  "UserPassword": "bookshelf"
}
{
    "Access": {
        "Accessable": "N"
    }
}
Situationunknown Bookshelf/VitalSource user
{
  "EAN": "9789084999912",
  "UserId": "Tester@cb-logistics.nl",
  "UserPassword": "bookshelf"
}
{
    "Message": {
        "MessageType": "I",
        "MessageCode": "EBS-10038",
        "MessageText": "Vitalsource user account unknown."
    },
    "Access": {
        "Accessable": "N"
    }
}


Test environment


For testing the following data is available (other data will result in an error response):

Invalid Vitalsource account credentials (UserId/UserPassword)Tester@cb-logistics.nl / bookshelf
Valid Vitalsource account credentials (UserId/UserPassword)bookshelf@cb-logistics.nl / bookshelf
Accessible EAN9789084999912
Inaccessible EAN8711000287941