net.olamaelcu.livtet.biblio.review.create

Create a community.lexicon.media.book.review record for the caller.

Details · procedure
Kindprocedure
Authorityreview.biblio.livtet.olamaelcu.net
Indexed

Procedure

procedure · POST

Input

application/json

content

union

Optional client-specific rich content; each object carries a $type.

One of

Optional presentation flags.

rating

integer

Rating on a 1-20 scale; divide by four for a five-star display.

  • minimum: 1
  • maximum: 20

subject

requiredref

Self-contained book reference the review is about.

subjectRecord

string · at-uri

Optional AT-URI of an edition record for enrichment.

Plain-text review.

  • minLength: 1

Output

application/json

uri

requiredstring · at-uri

AT-URI of the new review record.

Similar lexicons

semantic match

Lexicons 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

  • A 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).