Unlockr API v1

REST-API для проверки ключей, верификации Claude-аккаунта по sessionKey и запуска активации подписки.

Базаhttps://keyer.icu/api/v1

Успех{ "ok": true, "data": { … } }

Ошибка{ "ok": false, "error": { "code", "message" } }

Авторизация

Все эндпоинты кроме /ping требуют заголовок X-Api-Key. Демо-ключ: unl_live_demo_7Kq2.

Формат ключа активации: dorchik<N>-x<N>, где N — множитель тарифа: dorchik5-x5 → Claude Max ×5, dorchik20-x20 → Claude Max ×20.

Эндпоинты

GET/ping

Здоровье сервиса. Без авторизации.

200 OK

{ "ok": true, "data": { "service": "unlockr", "version": "1.0.0", "playwright": true } }

POST/keys/inspect

Проверка ключа активации: продукт, план и статус (использован / нет). Ключ не гасится.

Request

{ "key": "dorchik5-x5" }

200 OK

{ "ok":true, "data":{
  "key":"dorchik5-x5",
  "product":"Claude Max 5× · 1 month",
  "plan":"claude_max5",
  "status":"unused"
}}

Поле	Тип	Описание
`key`	string	`dorchik<N>-x<N>`, N ∈ {5, 20}

400 · invalid_key

{ "ok":false, "error":{ "code":"invalid_key", "message":"Key format is dorchik<N>-x<N> (N = 5 or 20)." }}

POST/account/verify

Верификация Claude-аккаунта по sessionKey: логинится в свежем браузере, читает организации, определяет активную подписку. Ключ не сохраняется. 30–60с.

Request

{ "session": "sk-ant-sid02-…" }

200 OK

{ "ok":true, "data":{
  "email":"[email protected]",
  "plan":null,
  "active_subscription":false,
  "org_id":"…uuid…"
}}

Ошибки

// 400 error.code = "invalid_session" | "bad_session"
// 502 error.code = "cf_blocked"

POST/activation/start

Запускает активацию: проверяет аккаунт и, если подписки нет, ставит заказ в очередь. Асинхронно — возвращает job_id.

Request

{
  "key": "dorchik20-x20",
  "session": "sk-ant-sid02-…"
}

202 Accepted

{ "ok":true, "data":{
  "job_id":"job_a1b2c3",
  "state":"checking"
}}

GET/activation/{job_id}

Статус задачи. Поллить каждые ~2.5с до терминального состояния.

state	Описание
`checking`	идёт проверка/применение
`activated`	готово — в `result`: email, product
`rejected`	на аккаунте уже есть подписка
`failed`	ошибка проверки

{ "ok":true, "data":{
  "id":"job_a1b2c3", "state":"activated",
  "result":{ "email":"[email protected]", "product":"Claude Max 20× · 1 month" }
}}

Примеры · curl

# 1) проверить ключ
curl -s https://keyer.icu/api/v1/keys/inspect \
  -H "X-Api-Key: unl_live_demo_7Kq2" -H "Content-Type: application/json" \
  -d '{"key":"dorchik5-x5"}'

# 2) проверить аккаунт (реальный вход по sessionKey)
curl -s https://keyer.icu/api/v1/account/verify \
  -H "X-Api-Key: unl_live_demo_7Kq2" -H "Content-Type: application/json" \
  -d '{"session":"sk-ant-sid02-..."}'

# 3) активация + опрос статуса
curl -s https://keyer.icu/api/v1/activation/start -H "X-Api-Key: unl_live_demo_7Kq2" \
  -H "Content-Type: application/json" -d '{"key":"dorchik20-x20","session":"sk-ant-..."}'
curl -s https://keyer.icu/api/v1/activation/job_a1b2c3 -H "X-Api-Key: unl_live_demo_7Kq2"

Unlockr API v1 · локальный сервис · активатор