Справочник APIГарантия

Подать заявку по гарантии

POSThttps://api.astrum.shop/v1/keys/{key_id}/claims
Область keys:write

Подписка пропала или не тот тариф — в течение 7 дней после активации ключа. Скриншот обязателен.

Решаем мы: перезапуск или цена ключа на баланс. Решение — в GET /v1/claims/{claim_id} и событием key.refunded, если вернули цену.

Параметры

key_id
в пути · uuid · обязательно

Номер ключа из ответа POST /v1/keys или списка.

Тело запроса

application/json
problem
string · обязательно

Что случилось:

not_working
подписки нет или ключ не работает
wrong_plan
включился не тот тариф
other
другое — опишите в comment
wish
string · обязательно

Чего хотите:

restart
перезапустить: новый ключ, лучше другого поставщика
refund
вернуть деньги на баланс

Перезапуск есть у activation; у card_payment — только цена ключа на баланс.

account_email
string | null

Почта аккаунта клиента — обязательна: по ней сверяем скриншот.

comment
string | null
screenshot_base64
string · обязательно

Скриншот проблемы: PNG, JPEG или WebP в base64, до 10 МБ.

Ответы

claim_id
string

Номер заявки.

order_id
string

Служебный номер попытки активации, по которой заявка; сам ключ — в key_id.

key_id
string | null

Ключ активации, по которому заявка; null — у старых заявок по заказам API (до 15.10.2026).

status
string

Статус заявки:

open
ждёт решения
restarted
перезапустили — новым ключом; клиенту, может быть, нужно снова прислать данные
refunded
деньги вернулись на баланс
refused
отказали — причина в refuse_reason
problem
string

Что случилось:

not_working
подписки нет или ключ не работает
wrong_plan
включился не тот тариф
other
другое — опишите в comment
wish
string

Чего хотели:

restart
перезапустить: новый ключ, лучше другого поставщика
refund
вернуть деньги на баланс
refuse_reason
string | null

Почему отказали; иначе null:

account_banned
аккаунт клиента заблокирован — гарантией не покрывается
plan_present
подписка на месте
wrong_screenshot
скриншот не о том
window_closed
гарантия закончилась
account_email
string | null

Почта аккаунта клиента из заявки; через 90 дней после решения стирается.

comment
string | null

Ваш комментарий.

created_at
string

Когда подана, UTC.

decided_at
string | null

Когда решена, UTC; null — ещё ждёт.

warranty_until
string | null

До какого времени действовала гарантия на момент заявки.

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

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/$KEY_ID/claims -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "problem": "not_working",
    "wish": "restart",
    "account_email": "client@example.com",
    "comment": "Вчера был Plus, сегодня Free",
    "screenshot_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  }'
Ответ
{
  "claim_id": "5c2e9a41-7d3b-4e8f-a1c6-2b9d0e4f7a13",
  "order_id": "b1e04c6e-5a0b-4f6e-9a39-0b9f2f1c8d21",
  "key_id": "9b2f6c1e-4d7a-4b0e-8f3c-1a5d2e7c9b40",
  "status": "open",
  "problem": "not_working",
  "wish": "restart",
  "refuse_reason": null,
  "account_email": "client@example.com",
  "comment": "Вчера был Plus, сегодня Free",
  "created_at": "2026-10-16T09:41:27Z",
  "decided_at": null,
  "warranty_until": "2026-10-21T10:32:40Z"
}