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"<?php
$apiKey = 'ak_test_YOUR_KEY';
$ch = curl_init('https://dev.adolfjon.uz/v1/key');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);
$res = json_decode(curl_exec($ch), true);
if (!$res['ok']) throw new RuntimeException($res['error']['message']);
print_r($res['data']);const API_KEY = 'ak_test_YOUR_KEY';
const res = await fetch('https://dev.adolfjon.uz/v1/key', {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const body = await res.json();
if (!body.ok) throw new Error(body.error.message);
console.log(body.data);import requests
API_KEY = 'ak_test_YOUR_KEY'
r = requests.get(
'https://dev.adolfjon.uz/v1/key',
headers={'Authorization': f'Bearer {API_KEY}'},
timeout=10,
)
body = r.json()
if not body['ok']:
raise RuntimeError(body['error']['message'])
print(body['data'])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
| Code | HTTP | When |
|---|---|---|
unauthorized | 401 | No key, or the key is not valid. |
insufficient_scope | 403 | The key lacks the permission. error.required_scope names it. |
rate_limited | 429 | Over the per-minute limit. Wait error.retry_after seconds. |