REST APIReference
Keys
POST
Returns a new key, once. It cannot be shown again. No authentication, no email. Limited per address.
application/json- body
label?stringA name for you to tell your keys apart. Optional.
Length
length <= 60The new key.
application/json- response
data*curl -X POST 'https://inetgeek.com/api/v1/keys' \ -H 'Content-Type: application/json' \ -d '{ "label": "my app"}'Example Response
{ "data": { "api_key": "string", "prefix": "string", "label": "string", "created_at": "2019-08-24T14:15:22Z", "limits": { "requests_per_minute": 0 }, "note": "string" }}DELETE
Revokes the key in the request. A server instance that already trusted it may accept it for up to a minute.
header
X-Api-Key<token>A key from POST /keys, starting igk_. Never send it in the URL.
Revoked.
application/json- response
data*curl -X DELETE 'https://inetgeek.com/api/v1/keys'Example Response
{ "data": { "revoked": true, "prefix": "string", "note": "string" }}GET
Returns 200 with the key's prefix, label and limits when the key is valid,
and 401 when it is missing, malformed, unknown or revoked. Costs one request
against the limit. Use it to verify a key without fetching data.
header
X-Api-Key<token>A key from POST /keys, starting igk_. Never send it in the URL.
The key is valid.
application/json- response
data*curl -X GET 'https://inetgeek.com/api/v1/account'Example Response
{ "data": { "prefix": "string", "label": "string", "created_at": "2019-08-24T14:15:22Z", "limits": { "requests_per_minute": 0 } }}