mocop
Browse · Docs · Guide · Analyze

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.
About · Contact · Privacy