Adolfjon API v1 · private beta

Build on Adolfjon.uz

One clean REST API for the catalog, your balance, orders, VIP plan and Hour Boost. Test keys from day one, docs with copy-paste code, and full control over every key you create.

Terminal
$ curl https://dev.adolfjon.uz/v1/me/balance \
    -H "Authorization: Bearer ak_test_…"
{
    "ok": true,
    "data": {
        "balance": 245000,
        "currency": "UZS",
        "as_of": "2026-10-26T14:05:00+05:00"
    },
    "meta": {
        "request_id": "req_3f9a0c1d2e4b5a6978c0",
        "mode": "live"
    }
}
14endpoints in v1
30/min2 000 requests a day per key
ak_test_sandbox keys with realistic data
JSONone response shape everywhere

From zero to first request

Every app is reviewed by a person, so the API stays safe for everyone on Adolfjon.

Apply

Sign in with your Adolfjon account and tell us what you are building. Accounts need to be 7+ days old with Telegram or Google linked.

Build with a test key

Right after you apply, create an ak_test_ key. Account endpoints return realistic fake data, so you can build safely.

Go live

Once approved, create an ak_live_ key with only the permissions you need. Lock it to your server IP if you like.

What you can read

v1 is read-only: no money moves and nothing is deleted through the API. Each key only gets the permissions you pick.

Catalog

Products, categories, prices and public news.

catalog:read

Account

Your profile: nickname, plan, level, linked logins.

account:read

Balance

Your balance and balance history.

balance:read

Orders

Your store orders (order info only, never the delivered items).

orders:read

Licenses

Your VIP / LITE plan and expiry.

licenses:read

Hour Boost

Your Hour Boost plans, hours and status.

boost:read

Notifications

Your site notifications.

notifications:read

Control built in

Scoped keys

Pick exactly which data a key can read. A key without balance:read never sees your balance.

IP allowlist

Lock a key to your server's IPs. Calls from anywhere else get ip_not_allowed.

New IP alerts

When a key is used from a new IP, you get a Telegram and email alert with a link to revoke it.

Keys expire in 90 days

We remind you 7 days before. Roll a key in one click; the old one keeps working for 24 hours.

Works with AI

Plug your key into Claude, Cursor or ChatGPT through our MCP server. Read-only, same limits.

Webhooks

Get order.paid, balance.changed and boost.status pushed to your server, signed. How it works

Request log

See every call your app made in the last 30 days: path, status, time and IP.

OpenAPI file

Download the Postman collection in one click, or use /openapi.json to generate a client in any language.

Ready when you are

Read the quick start, then create a test key. It takes about five minutes.

API reference Get an API key