OpenRiC API Explorer

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.x description 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, and they belong on a server whose data you may change: to practise, run the minimal server as the getting-started guide does. Keys for the reference server are issued for agreed testing through the form at ric.theahg.co.za/api/ric/v1/keys/request, reviewed by an admin. Other OpenRiC servers issue keys their own way.

What next?

If you're integrating, check whether your server offers its own explorer; the reference server has one at {base}/docs. This standalone page at openric.org is for evaluating multiple servers without having to hit /docs on each.

Questions? Discussions.