Documentation / v1
Start with a request.
INFOrmantion is a free, unauthenticated JSON API. Choose an endpoint and use standard HTTP.
Getting started
Call any live endpoint over HTTPS. Responses use a consistent envelope with success, data, and request metadata.
curl 'https://informantion.com/api/v1/status'Authentication
No API key is required for the current v1 endpoints. Please identify high-volume integrations with a stable User-Agent.
Rate limits
The initial fair-use guard allows 60 requests per minute, per endpoint and observed client address. Enforcement is per active edge instance in this release; the returned headers are authoritative for the current request path.
RateLimit-LimitMaximum requests in the current window.RateLimit-RemainingRequests remaining in that window.RateLimit-ResetSeconds until reset.Errors
Errors are JSON, use meaningful HTTP status codes, and include a stable machine-readable code.
{
"success": false,
"error": {
"code": "INVALID_PARAMETER",
"message": "The supplied value is invalid."
}
}API versioning
The major version is part of every route: /api/v1/…. Breaking changes will use a new major version.
CORS
Public endpoints accept cross-origin requests from any origin. Allowed methods are limited to the methods documented for each endpoint.
Usage policy
Use the APIs for legitimate applications, prototypes, education, and research. Do not attempt to disrupt availability, bypass fair-use controls, or use generated values as passwords or long-term secrets.