POST api/book/epub

V1 - Decrypts an encrypted ePub file

Request Information

URI Parameters

None.

Body Parameters

YindoOfflineBook
NameDescriptionTypeAdditional information
bookID

The ID for this book

integer

None.

ean

A 13 digit EAN. This starts with 978- for 'real' books and with 888- for Yindo Custom Books

string

None.

altean

A 13 digit EAN. This starts with 978- for 'real' books and with 888- for Yindo Custom Books

string

None.

title

The title for this book.

string

None.

encryptedOn

The encryptiondate for this books data.

date

Data type: DateTime

validUntil

The expirationdate for this books data.

date

Data type: DateTime

dataFormat

The format of the encrypted content.

DataFormats

None.

fileCount

The number of files in the encrypted zipfile

integer

None.

fileSize

The total size in bytes of all unencrypted, uncompressed files in the encrypted zipfile

integer

None.

bookData

Encrypted data (AES-CBC), base64 encoded
The data contains the following blocks needed for decryption.

  • 32 bytes salt
  • 16 bytes nonce
  • n bytes payload
  • 32 bytes HMac-Tag
NOTE: this data needs to be base64 decoded first!

string

None.

statusCode

A statuscode indicating succes or failure

StatusCode

None.

Request Formats

application/json, text/json

Sample:
{
  "bookID": 1,
  "ean": "sample string 2",
  "altean": "sample string 3",
  "title": "sample string 4",
  "encryptedOn": "2026-02-20T15:50:30.8533239+01:00",
  "validUntil": "2026-02-20T15:50:30.8533239+01:00",
  "dataFormat": 1,
  "fileCount": 7,
  "fileSize": 8,
  "bookData": "sample string 9",
  "statusCode": 0
}

text/javascript

Sample:
{"bookID":1,"ean":"sample string 2","altean":"sample string 3","title":"sample string 4","encryptedOn":"2026-02-20T15:50:30.8533239+01:00","validUntil":"2026-02-20T15:50:30.8533239+01:00","dataFormat":1,"fileCount":7,"fileSize":8,"bookData":"sample string 9","statusCode":0}

application/xml, text/xml

Sample:
<YindoOfflineBook xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Yindo">
  <altean>sample string 3</altean>
  <bookData>sample string 9</bookData>
  <bookID>1</bookID>
  <dataFormat>ePub</dataFormat>
  <ean>sample string 2</ean>
  <encryptedOn>2026-02-20T15:50:30.8533239+01:00</encryptedOn>
  <fileCount>7</fileCount>
  <fileSize>8</fileSize>
  <statusCode>Success</statusCode>
  <title>sample string 4</title>
  <validUntil>2026-02-20T15:50:30.8533239+01:00</validUntil>
</YindoOfflineBook>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'YindoOfflineBook'.

Response Information

Resource Description

HttpResponseMessage
NameDescriptionTypeAdditional information
Version

Version

None.

Content

HttpContent

None.

StatusCode

HttpStatusCode

None.

ReasonPhrase

string

None.

Headers

Collection of Object

None.

RequestMessage

HttpRequestMessage

None.

IsSuccessStatusCode

boolean

None.