Список ключей

GEThttps://api.astrum.shop/v1/keys
Область keys:read

Ключи вашего магазина — свежие сверху. Фильтры: статус, номер заказа, тариф.

Параметры

status
в запросе · string | null

Статус ключа.

ref
в запросе · string | null

Ваш номер заказа из покупки.

product_id
в запросе · uuid | null

Тариф.

page
в запросе · integer

Страница, по 50 ключей; за последней — пустой keys.

Ответы

keys
array

Ключи этой страницы; за последней страницей — пустой список.

↳key_id
string

Номер ключа у нас — для GET /v1/keys/{key_id}.

↳code
string | null

Ключ для клиента: XXXX-XXXX-XXXX-XXXX.

↳link
string | null

Ссылка на страницу активации — ключ подставится сам.

↳status
string

Состояние ключа:

available
свободен — его можно отдать клиенту
activating
клиент прислал данные, включаем
activated
подписка включена
expired
сгорел — не активирован в срок
refunded
цену вернули на баланс
↳product_id
string
↳title
string

Название тарифа.

↳delivery_method
string
↳kind
string | null
↳subscription_days
integer | null
↳price_usdt
string

Цена ключа — сколько списано за него.

↳ref
string | null

Ваш номер заказа из покупки.

↳created_at
string
↳expires_at
string

Когда сгорит, если не активировать: через 45 дней после покупки.

↳activated_at
string | null
↳warranty_until
string | null

До какого момента действует гарантия (7 дней с активации).

↳last_attempt_failed_at
string | null

Когда в последний раз активация не прошла — ключ после этого снова свободен.

↳last_attempt_reason
string | null

Почему последняя попытка не прошла:

verification_declined
клиент отказался от проверки личности
not_activated
подписку включить не вышло — попытку закрыли

null — неудачных попыток не было.

total
integer

Сколько ключей подходит под фильтры.

page
integer

Номер страницы — как в запросе.

pages
integer

Сколько всего страниц, по 50 ключей; не меньше 1.

Общие для всех методов — подробно в разделе «Коды ошибок»:

10001 invalid_key10002 key_scope_missing10003 ip_not_allowed10004 browser_not_allowed10005 account_suspended20001 too_many_requests90002 api_disabled90001 internal_error
тестовые USDT,
ключ ask_test_…
curl https://api.astrum.shop/v1/keys \
  -H "Authorization: Bearer $ASTRUM_KEY"