A book within the hive
Record Key
tid
Timestamp-based ID
Properties
authors
string
Required
The authors of the book (tab separated)
maxLength: 512 bytesminLength: 1 bytescover
string
Optional
URL to full-size cover image
createdAt
string
datetime
Required
An RFC 3339 formatted timestamp.
description
string
Optional
Book description/summary
maxLength: 5000 bytesid
string
Required
The book's hive id, used to correlate user's books with the hive
identifiers
ref
buzz.bookhive.defs#bookIdentifiers
Optional
External identifiers for the book
rating
integer
Optional
Average rating (0-1000)
minimum: 0maximum: 1000ratingsCount
integer
Optional
Number of ratings
source
string
Optional
The source service name (e.g. Goodreads)
sourceId
string
Optional
ID of the book in the source service
sourceUrl
string
Optional
URL to the book on the source service
thumbnail
string
Required
URL to thumbnail image
title
string
Required
The title of the book
maxLength: 512 bytesminLength: 1 bytesupdatedAt
string
datetime
Required
An RFC 3339 formatted timestamp.
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"id",
"title",
"authors",
"createdAt",
"updatedAt",
"thumbnail"
],
"properties": {
"id": {
"type": "string",
"description": "The book's hive id, used to correlate user's books with the hive"
},
"cover": {
"type": "string",
"description": "URL to full-size cover image"
},
"title": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "The title of the book"
},
"rating": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Average rating (0-1000)"
},
"source": {
"type": "string",
"description": "The source service name (e.g. Goodreads)"
},
"authors": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "The authors of the book (tab separated)"
},
"sourceId": {
"type": "string",
"description": "ID of the book in the source service"
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"sourceUrl": {
"type": "string",
"description": "URL to the book on the source service"
},
"thumbnail": {
"type": "string",
"description": "URL to thumbnail image"
},
"updatedAt": {
"type": "string",
"format": "datetime"
},
"description": {
"type": "string",
"maxLength": 5000,
"description": "Book description/summary"
},
"identifiers": {
"ref": "buzz.bookhive.defs#bookIdentifiers",
"type": "ref",
"description": "External identifiers for the book"
},
"ratingsCount": {
"type": "integer",
"description": "Number of ratings"
}
}
},
"description": "A book within the hive"
}