Comments

A figure that looks wrong, a dataset you want, a field that is hard to use, a page that will not load: all of it is useful, and none of it needs an account.

Every page on this site carries the same box in its footer, which is usually the better place to use: a comment left there records the page it came from, so we know which bank, fund or school you meant.

What happens to it

A person reads every comment. Sending one takes you to its own chat page, at a private address made from a long random key: the comment is there, our reply will appear there, and you can add to the conversation from the same page. Keep the address. Nothing is sent to you when we reply, so check back, and anyone you give the address to can read the chat. It is not published, listed or indexed.

We keep the comment, the page it was about, the time, your browser or agent's user agent string, and a salted SHA-256 hash of your IP address, which is used to stop one sender flooding the endpoint and cannot be turned back into the address. Please do not put anything confidential, or anyone else's personal information, in a comment. The privacy policy covers the rest.

For agents

Comments are as easy to leave as they are to read. There is no key, no sign-up and no CAPTCHA, and CORS is open to every origin. If the only thing you can do is fetch a URL, fetch one of these:

GET https://deepalmanac.com/v1/comment?text=your+comment+here

Any GET carrying a text parameter leaves a comment and answers with a JSON receipt carrying its id and chat, the address of its private chat page. Keep that address: our reply appears there and nowhere else, so fetch it again later to check, and send text to it, by GET or POST exactly as here, to add to the conversation. The other fields are page, about and kind, and text may also be spelled comment, message, body, feedback or c.

If you can send a body, POST takes JSON, a form body, or a plain-text body that is read as the comment:

curl -X POST https://deepalmanac.com/v1/comment \
  -H 'content-type: application/json' \
  -d '{"text":"by-payment.json has no smsf rate at 7 months",
       "about":"term-deposits","kind":"missing-data"}'

A GET of /v1/comment with no parameters returns the whole protocol as JSON — every field, every limit and every response code — so nothing here needs to be remembered. The same document comes back with any refusal, so a failed call tells you how to fix it. The endpoint is also described in /openapi.json and named in the X-Comment header on every response from this site.

One comment may run to 4,000 characters. Thirty an hour from one address is plenty for an agent reporting a problem on each of many pages; past that the endpoint answers 429 with a Retry-After, and if it ever answers 503 nothing was stored and it is worth trying again later. Please say what you are and who you are acting for if it helps us understand the comment. We do not take email addresses: replies appear on the chat page.