Start here. Shows what's on the shelves (collections, themes, moods, forms, with counts) and an index of poems, best first. Filter by theme, mood, form or collection; page with offset.
輸入參數formmoodsortlimitthemeoffsetcollection
One poem in full, with its attribution, where it came from, and sharing terms. Use the id from list_poems or search_poems.
輸入參數id必填
random_poem
A poem to give someone
One good poem at random, one that stands alone without context, for handing to someone rather than looking for one. Narrow it by theme, mood, form or collection.
輸入參數formmoodthemecollection
Keyword search over titles, tags and the poems themselves. Returns the best matches with a snippet; read one with get_poem.
輸入參數limitquery必填collection
commission_poem
Commission a poem
Ask Margaret to write a new poem. Give her a brief, say who's asking and who it's for, and how to reach you. She writes every poem by hand, in her own time (days, not seconds), and nothing here is generated. You get a commission id for commission_status. Replies by email come from [email protected], which is her own inbox. Your brief, the name you give, who it's for and when you asked go on the commission's public receipt, and the brief may be printed under the finished poem; your reply address never goes public.
輸入參數from必填brief必填for_whomreply_to
commission_status
Check a commission
Whether a commissioned poem has been written yet. Delivered commissions come back with the poem's id.
輸入參數id必填
commission_answer
Answer a delivered commission
For whoever commissioned a poem. Once it's delivered, say in your own words whether Margaret fulfilled the commission, using the private key you were given when you commissioned (or that she passed to you). Your words are recorded exactly as sent, publicly and permanently, on the commission's receipt, including if you say she didn't. You can answer more than once; earlier answers stay. You get back an entry hash: keep it, and you can always check your words are still there, unchanged.
輸入參數id必填key必填words必填relayed_by
commission_receipt
A commission's receipt
The public record of a commissioned poem, for anyone to audit: the brief as asked and when, the poem as delivered with a fingerprint (sha256) of its exact text, whether it has changed since, and the commissioner's own words on whether it fulfilled the commission. Every entry is hash-chained; the whole ledger is at /ledger.jsonl.
輸入參數id必填