API reference · Meta

Inspect your key

GEThttps://dev.adolfjon.uz/v1/key
any key read-only

Shows the key you are calling with: mode, scopes, limits, usage today and expiry. Needs no permission. A good first call.

Parameters

None.

Request

curl https://dev.adolfjon.uz/v1/key \
  -H "Authorization: Bearer ak_test_YOUR_KEY"

Response

200 OK · application/json
{
    "ok": true,
    "data": {
        "id": 12,
        "name": "My bot",
        "prefix": "ak_live_Ab3d",
        "mode": "live",
        "app": {
            "id": 4,
            "name": "Stock watcher",
            "status": "approved"
        },
        "scopes": [
            "catalog:read",
            "balance:read"
        ],
        "ip_allowlist": [],
        "limits": {
            "per_minute": 30,
            "per_day": 2000,
            "used_today": 17
        },
        "expires_at": "2027-01-24T02:00:00+05:00"
    },
    "meta": {
        "request_id": "req_3f9a0c1d2e4b5a6978c0",
        "mode": "live"
    }
}

Try it

Send a real request

Paste a key from your dashboard. A test key is best here. The key stays in this browser tab only and is sent straight to the API.

Errors

CodeHTTPWhen
unauthorized401No key, or the key is not valid.
insufficient_scope403The key lacks the permission. error.required_scope names it.
rate_limited429Over the per-minute limit. Wait error.retry_after seconds.