Basic usage
Learn the basics of using the Runes API.
Usage
The Runes API is built on REST principles, enforcing HTTPS for all requests to ensure data security, integrity, and privacy.
Base URL
https://api.hiro.so
Making requests
To make a request to the Runes API, you can paste the curl command below in your terminal.
Terminal
$curl -L 'https://api.hiro.so/runes/v1/etchings' \-H 'Accept: application/json'
Authentication
If you are using an api-key, replace $HIRO_API_KEY
with your secret API key.
Terminal
$curl -L 'https://api.hiro.so/runes/v1/etchings' \-H 'Accept: application/json' \-H 'X-API-Key: $HIRO_API_KEY'
Response codes
The Runes API uses standard HTTP response codes to indicate request success or failure.
Code | Description |
---|---|
200 | Successful request |
400 | Check that the parameters were correct |
401 | Missing API key |
403 | Invalid API key |
404 | Resource not found |
429 | Rate limit exceeded |
5xx | Server errors |