OpenRiC API Explorer

Server base URL (path to /api/ric/v1)

API key (only for write endpoints)

Quick-load: Reference server (ric.theahg.co.za)

Paste a server URL and click Load. The page fetches {server}/openapi.json and renders Swagger UI from it.

What is this?

The OpenRiC API Explorer is an interactive test console for any server that implements the OpenRiC Viewing + Write API. It loads the server's openapi.json and renders it with Swagger UI so you can:

Browse every endpoint grouped by entity type (Agents, Records, Places, Rules, Activities, Instantiations, Relations, Graph, OAI-PMH).
See the request + response schemas for each.
Try endpoints directly from the browser — paste an API key into Authorize and the explorer signs every write request with X-API-Key.

How does it work?

Every OpenRiC server serves a live OpenAPI 3.0 spec at {base}/openapi.json. The explorer fetches that document from whatever server you point it at — no build step, no server-side rendering on openric.org, no API key ever leaves your browser.

Don't have a key yet?

Reads are public — no key required. Writes need one. The reference server ships a self-service request form at ric.theahg.co.za/api/ric/v1/keys/request — fill the form, an admin reviews and emails you the key. Every OpenRiC-conformant server exposes this same path.

What next?

If you're integrating, bookmark your server's {base}/docs — every OpenRiC server ships the explorer under that path too. This standalone page at openric.org is for evaluating multiple servers without having to hit /docs on each.

Questions? Discussions.