community.lexicon.media.book.edition
Optional repository publication of an edition. Its fields mirror defs#edition; publishing a catalog on AT Protocol is not required.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | book.media.lexicon.community |
| Commit rev | 3n2h5svom4b25 |
| Indexed |
Checks
Validunlimited-stringdefs.main.record.properties.bookEditionNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.record.properties.descriptionNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.record.properties.formatNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.record.properties.subtitleNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.record.properties.titleNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Optional repository publication of an edition. Its fields mirror defs#edition; publishing a catalog on AT Protocol is not required.",
"key": "tid",
"record": {
"description": "Full edition metadata for books, including comic books and graphic novels, for embedding and optional repository publication. Provider APIs use editionView, which carries covers as URLs only.",
"properties": {
"bookEdition": {
"description": "Edition statement, such as 2nd revised or Abridged.",
"type": "string"
},
"chapters": {
"description": "Total chapter count, when known. This is an extent, not the reader's progress or a table of contents.",
"minimum": 0,
"type": "integer"
},
"contributors": {
"description": "Contributors credited on the edition. May be empty for anonymous or unknown contributions.",
"items": {
"ref": "community.lexicon.media.book.defs#contributor",
"type": "ref"
},
"type": "array"
},
"cover": {
"accept": [
"image/*"
],
"description": "Optional cover image, strongly recommended when storing in a repository. The blob must belong to the repository containing the record, including when embedded in a review. May coexist with coverUrl.",
"type": "blob"
},
"coverUrl": {
"description": "Optional cover image URL, useful for API responses and providers without repository storage. May coexist with cover; a URL alone does not preserve image bytes in the user's repository.",
"format": "uri",
"type": "string"
},
"createdAt": {
"description": "Time this edition record or snapshot was created, not its publication date.",
"format": "datetime",
"type": "string"
},
"description": {
"description": "Description of the edition.",
"type": "string"
},
"durationSeconds": {
"description": "Total audio duration in whole seconds, when known.",
"minimum": 0,
"type": "integer"
},
"format": {
"description": "Medium of the edition. Additional values are permitted; clients should provide a fallback for unrecognized formats.",
"knownValues": [
"physical",
"ebook",
"audio"
],
"type": "string"
},
"identifiers": {
"description": "Known identifiers for this edition, including provider grouping identifiers. Include the writing provider's identifier where available.",
"items": {
"ref": "community.lexicon.media.book.defs#identifier",
"type": "ref"
},
"minLength": 1,
"type": "array"
},
"language": {
"description": "Language of the edition as a BCP 47 language tag.",
"format": "language",
"type": "string"
},
"pages": {
"description": "Total page count for print or ebook editions, when known.",
"minimum": 0,
"type": "integer"
},
"publishedDate": {
"description": "Publication date in ISO 8601 format at its known precision: YYYY, YYYY-MM, or YYYY-MM-DD. Preserve available precision without inventing a month or day. Applications must validate the date; this is not a datetime.",
"maxLength": 10,
"minLength": 4,
"type": "string"
},
"publisher": {
"ref": "community.lexicon.media.book.defs#publisher",
"type": "ref"
},
"series": {
"ref": "community.lexicon.media.book.defs#series",
"type": "ref"
},
"subtitle": {
"description": "Subtitle of the edition.",
"type": "string"
},
"title": {
"description": "Title of the edition.",
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"identifiers",
"contributors",
"createdAt"
],
"type": "object"
},
"type": "record"
}
},
"description": "A specific published instance of a book, including comic books and graphic novels, such as one printing, translation, or audiobook production. Not a work: distinct editions of the same underlying text are distinct records. New metadata fields should follow the corresponding names, meaning, and shape in https://schema.org/Book, including inherited properties; document any adaptations or extensions.",
"id": "community.lexicon.media.book.edition",
"lexicon": 1
}