HTTP API
detent-authority --authority CONFIG runs the durable authority, which speaks HTTP/1.1
with JSON bodies, over TLS when its configuration enables publisher TLS.
| Endpoints | Authentication |
|---|---|
/v2/* | Bearer token |
/v1/health | None |
Examples on these pages are written as REST snippets:
GET /v1/healthHover a snippet and use the copy button to get the equivalent curl command
against http://localhost:8317.
Common Behavior
Section titled “Common Behavior”- Bodies are bounded. Authority request bodies are limited to 256 KiB.
- Errors are JSON. A rejected request returns
{"error":"..."}with an appropriate status code. Authentication and body-admission failures close the connection. - Identity is exact. Every
/v2request names the authority’scluster,groupandepoch.