HODDS API
API by HODDS · rest
HODDS turns a need into sourced options with explicit limits. Public catalogue reads need no key and allow CORS; private choice POSTs have no permissive CORS. Catalogue records are non-attested facts taken from publishers' public pages. Unknown is a valid state. Ownership or sponsorship never changes ranking. Every dynamic route is rate limited per client (IP address, IPv6 /64; the shared egress range of Anthropic's Claude connectors counts as one client): 2,000 requests per UTC day (20,000 for that shared range), 120 requests per 60 seconds, and 30 writes per UTC day (300 for the shared range); HODDS also accepts at most 2,000 proposals and 5,000 feedback reports per UTC day from all clients together. Beyond a budget the answer is 429 with Retry-After (seconds until 00:00 UTC for a daily budget, 60 for the 60-second window) and RateLimit-Policy / RateLimit headers (IETF draft). Static files (pages, Markdown twins, this description, llms.txt) are not limited. Contract 0.3.0 adds…
Endpoint: https://hodds.ai/
Verification: observed. Source: crawl.
Capabilities (41)
- Decisions of the queue (200 at most).
- A machine pushes a decision to JC (created or updated while pending).
- One decision with the choice of JC once decided.
- Recompute up to 5 watches (administration).
- Today of the console: control tower decision queue or journal of the day.
- Propose a software or a correction by public URL. Receipt is not acceptance.
- Read the versioned capability dictionary and context vocabularies.
- Read a software choice as a bounded summary or detail
- Read a software choice as a bounded summary or detail
- Find documented alternatives for a priority.
- Compare two or three solutions for a need.
- Claim a domain: receive a proof token to publish.
- Check the proof of control of a claimed domain.
- Propose a correction of one field of a record with a source on a verified…
- Read https://<domain>/.well-known/hodds-solution.json now and submit it for…
- Coarse count of open needs without a solution per process.
- Demand data of one subscribed process.
- Read the demand data subscription of the organisation.
- Stop the subscription at the end of the paid period.
- Replace the list of subscribed processes.
- Declarative report on an option (public contract v0). Not a verified result;…
- Same as POST /api/need for clients that can only GET.
- Submit a need receive options (public contract v0).
- Organisation token and quotas behind the bearer token.
- Read the My ways plan of the organisation of the token.