net.olamaelcu.livtet.biblio.review.create
Create a community.lexicon.media.book.review record for the caller.
Details · procedure
| Kind | procedure |
|---|---|
| Authority | review.biblio.livtet.olamaelcu.net |
| Indexed |
Procedure
procedure · POSTInput
application/jsoncontent
unionOptional client-specific rich content; each object carries a $type.
flags
refOptional presentation flags.
rating
integerRating on a 1-20 scale; divide by four for a five-star display.
minimum: 1maximum: 20
Self-contained book reference the review is about.
subjectRecord
string · at-uriOptional AT-URI of an edition record for enrichment.
textContent
stringPlain-text review.
minLength: 1
Output
application/jsonAT-URI of the new review record.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
A portable review with an embedded book reference.
-
A user's review of a book. StrongRefs the catalog book and optionally the originating bookShelving. rkey: tid. Written by the OAuth client (livtet-service) via com.atproto.repo.putRecord.
-
A review of one edition by an actor. Duplicate convention: the rkey is a TID minted once at first create and never changes. Several records may exist for one actor and edition (for example from out-of-band writers); consumers SHOULD treat the record with the greatest `updatedAt` (falling back to `createdAt`) as the winner and break ties by the lowest TID, ignoring the others. This is a convention, not an enforced contract: AppViews MUST tolerate a differing winner, and may see a record's catalog
-
com.divepool.rating
recordA rating gives a subject a dated integer score from 1 to 10. To re-rate, create a new record with an updated createdAt; the current score is the latest per (author, subject).