reader

Create an audiobook

Send an id to choose your own (an ISBN, your primary key); omit it and one is generated. Creating with an id that already exists updates it — identical to PUT /v1/reader/audiobooks/{id}.

post/v1/reader/audiobooks

Request

  • Base URL: https://api.ditto.audio (the document declares no server; this is the origin it was published from)
  • URL: https://api.ditto.audio/v1/reader/audiobooks
  • Auth: HTTP bearer

Request body

idstring

Your own stable id for this audiobook (an ISBN, a uuid, your primary key). Ignored on PUT — the path wins. Omit on POST and one is generated.

titlestring required
authorstring
formatstring

Source document type.

chapterCountnumber

How many chapters the source has.

contentHashstring

sha-256 of the source file, lowercase hex. Enables upload dedup.

coverImageUrlstring

https:// or data:image/ URL.

Example request

{
  "id": "moby-dick",
  "title": "Moby-Dick",
  "author": "Herman Melville",
  "format": "epub"
}

Changes

No recorded changes to this operation across all 1 revision of this API.