Getting started
The Qriton API is a JSON over HTTPS interface at https://api.qriton.com/v1. It has four parts, each with its own reference: the Verification API, the Memory API, the Spatial Memory API and the Signals API.
1. Create an account and a key
Sign in at https://api.qriton.com/console with your e-mail address and the code we send. New accounts start on the Free plan. In the console, create an API key; it is shown once, so store it in your secret manager.
2. Make a first call
curl https://api.qriton.com/v1/account -H "Authorization: Bearer $QRITON_API_KEY"
The answer names your plan, the APIs it includes and the allowance left in the current window.
3. Verify a receipt chain
The Verification API is included in every plan. Download the sample chain from the open verifiers page and send it:
curl https://api.qriton.com/v1/verify/receipts \
-H "Authorization: Bearer $QRITON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonl": "<contents of receipts.jsonl>", "expected_head": "<head you hold>"}'
Conventions
- Requests and responses are JSON (UTF-8) unless an operation states otherwise. Times are ISO 8601 in UTC.
- Every response carries
X-Request-Id. Quote it when you contact us about a request. - Request bodies are limited to 10 MB.
- The version is part of the path. Changes within
/v1only add fields or operations; anything else gets a new version and notice in Changes.