GET /vital_books/:vbid - Read

This API returns VitalBook asset information for a given VBID.  

Verb/URI

GET https://services.vitalbook.com/vital_books/{{VBID}}.xml

Data Definitions

The minimum fields needed to request a VBID 

Name
Usage
Description
Data Type
Example & Details
Required
api_key Query param

your VitalSource API key

string  ALLCAPSANDNUMBERS Yes

 

Request Headers

Request header - default example (using cURL)

curl -X GET \
'https://services.vitalbook.com/vital_books/L-999-70049.xml?api_key=YOUR_API_KEY_HERE' \
-H 'Accept: */*' \
-H 'Accept-Type: application/xml' \
-H 'Host: services.vitalbook.com' \

Response

Response body - default

<?xml version="1.0" encoding="UTF-8"?>
<vital_book vbid="L-999-70049">
<build_status>approved</build_status>
<title>Great Expectations</title>
<price/>
<store_price/>
<digital_list_price/>
<edition>0</edition>
<imprint_id>100</imprint_id>
<vbk_format>epub</vbk_format>
<fpid/>
<faculty_review_only>0</faculty_review_only>
<fulfillment_only>0</fulfillment_only>
</vital_book>

Response Descriptions

Name
Description
build_status Response from the VitalSource build system
title Title sent with asset
price Price sent with asset, if applicable
store_price VitalSource store price of asset, if applicable
digital_list_price DLP sent with asset, if applicable
edition current edition of asset
vbk_format digital format of asset. (Note: page_fidelity is the official name for PDF)

  

Error Codes

HTTP & Error messages 
Message
Notes
200

Success

The build process was successful and the book is ready.
403

The api_key is incorrect or does not have the proper permissions to access this service

 
404

User was not found

 
500

Error creating the VitalBook

Verify required fields
500

Could not process the source file

VitalSource was able to download the source file, but we were unable to process the file. This may be caused by formatting issues with the PDF/EPUB or file corruption.
500

Could not retrieve the source file

VitalSource was not able to download the source file from the given url.

 

Was this article helpful?
0 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.