Crate cactive_hypixel_api
source · [−]Expand description
Unofficial Hypixel API by CactiveNetwork
This is an implementation of the API in Rust, however you’re welcome to request data directly.
The method of collecting data is private, hence why a key system is required.
Disclaimer:
- We are not associated nor should we be considered affiliated with Hypixel.
- A valid API key is required to successfully request player, nickname, ban and other data from this API. You can request an API key running
-ticket open
in this discord providing you meet criteria.
Error Types
In the case that your request is invalid, maintenance is done on the API, or the tunnel collecting data is blocked or locked out, you will receive an error, which you should look out for.
This wrapper adds an internal
field to the object in your array of errors, which will be true
if the error is internal to your device (unable to send request or parse JSON), otherwise false.
no-authentication
- You didn’t provide the relevant authentication information (key field).no-identifier
- You didn’t provide the relevant username, id, or such required identification field.no-filter
- You didn’t provide the relevant filter field to your request.invalid-authentication
- The authentication information provided in the request was invalid.invalid-filter
- The filter provided in the request was invalid.invalid-endpoint
- The endpoint provided in the request was invalid.tunnel-blocked
- Unable to interface with the required relevant request data.hypixel-maintenance
- Unable to complete because one of the data sources are offline.rate-limit-blocked
- You are being rate limited for sending too many valid requests.failed-api-request
NODE CLIENT - The client failed to send a valid request to the server.unexpected-error
- An unexpected error occurred on the API server.
Rate Limits
- Standard requests are limited to
10 requests per minute
. - Smart-cached requests (semi-accurate data) are limited to
30 request per minute
.
You are expected to respect these limits, and if you do not, you will be blocked from the API.