SubHelpВсё необходимое после покупки
Поддержка11:00–00:00 (МСК)

API для интеграций v1

Активация купленных кодов на вашем сайте.

Подключение

REST · JSON
Адрес APIhttps://subhelp.pro/api/v1

Персональный API-ключ выдаём в чате вашего заказа.

Руководство · RU

Справочник API

Откройте только то, что нужно сейчас.

Продукты и запросы

ChatGPT, Claude, Perplexity, Google AI Pro и Duolingo

Выберите сервис. Меняются только product и данные account.

Полная актуальная Session аккаунта как JSON-строка. Не отдельный токен и не email. Получайте её только от владельца аккаунта.

sessionобязательно
Полная Session в строке; используйте JSON.stringify, не собирайте экранирование вручную.
Полный запрос запуска · ChatGPT
curl --fail-with-body 'https://subhelp.pro/api/v1/activations' \
  --header "Authorization: Bearer $SUBHELP_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: order-10482-attempt-1' \
  --data '{
  "product": "chatgpt",
  "code": "<purchased-activation-code>",
  "account": {
    "session": "<complete account Session JSON as a string>"
  }
}'

Не добавляйте поля вне схемы. Срок подписки определяется купленным кодом; поставщика и длительность в запросе выбирать не нужно.

Только с вашего backend по HTTPS. Для POST используйте Content-Type: application/json. Примеры ничего не отправляют.

Методы API

Проверка кода, запуск и получение результата

Все пути ниже начинаются с /api/v1. Только запуск отправляет активацию.

GET/products

Список товаров, разрешённых вашему ключу, и полей account.

POST/codes/check

Нерасходующая проверка кода там, где она поддерживается. valid: null — доступность не подтверждена.

POST/activations

Запуск с обязательным Idempotency-Key. 202 — ожидание; 200 — конечный результат. Сохраните data.id.

GET/activations/by-idempotency-key

Восстановление ID по исходному Idempotency-Key, без Session, пароля или 2FA. Поставщик не вызывается.

GET/activations/{id}

Текущий результат вашей заявки. HTTP 200 возможен и при processing / review. Новый запуск не выполняется.

Для SSOP проверка читает остаток активаций, а для G12 — реальную текущую доступность без расходования и без раскрытия внутреннего состояния. Для M6 / M12 / M24 и Perplexity PXY / PXY2 проверяется только формат. Ответ valid: null с кодом code_format_valid не подтверждает доступность.

Статусы и ошибки

Как обработать ответ и показать результат

ok: true означает, что запрос обработан. Подписка активна только при data.status: completed.

JSON · В обработке
{
  "ok": true,
  "requestId": "00000000-0000-4000-8000-000000000101",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "product": "claude",
    "status": "processing",
    "code": "activation_processing",
    "message": "Activation is being processed. Check this activation again; do not submit a new one.",
    "retryable": false,
    "retryAfterMs": 12000,
    "createdAt": "2026-11-10T10:00:00.000Z",
    "updatedAt": "2026-11-10T10:00:12.000Z"
  }
}

requestId — ID HTTP-запроса для поддержки. data.id — постоянный ID активации. Не путайте их.

СтатусЧто делать
processingХраните ID и проверяйте статус. Новый запуск не нужен.
reviewРезультат ещё не подтверждён. Проверяйте тот же ID или обратитесь в поддержку; это не ошибка активации.
completedПодписка активна. Остановите проверку статуса.
failedОстановите обычную проверку. Изучите code и retryable; не создавайте повтор автоматически.
action_requiredПокажите необходимое действие. Если причина неясна — обратитесь в поддержку.

Причина / HTTP

401 · unauthorized

Проверьте серверный API-ключ и его доступность.

403 · product_not_allowed

Запросите у SubHelp доступ к нужному продукту.

408 · request_timeout

JSON не получен за 15 секунд. Повторите тот же запрос; для запуска сохраните тот же Idempotency-Key.

409 · idempotency_conflict

Этот ключ уже использован с другими данными. Восстановите исходную заявку.

manual_activation_failed

Исправьте данные G12, дождитесь retryAfterMs и только затем создайте новую логическую попытку с новым ключом.

429 · rate_limited / retry_not_ready

Выждите Retry-After; не меняйте ключ для обхода паузы.

5xx · temporarily_unavailable

Восстановите исходный ID по тому же ключу и читайте статус через GET после паузы. Не считайте заявку неуспешной.

activation_not_sent

Подтверждает, что отправки не было. После задержки разрешена новая логическая попытка с новым ключом.

activation_already_submitted

Код уже связан с другой отправкой. Проверьте исходный заказ или обратитесь в поддержку; новый аккаунт не активирован.

transfer_confirmation_required

Сохраните исходную заявку и обратитесь в поддержку. API не подтверждает перенос подписки; confirmOverride не разрешает его.

400 / 422 — исправьте входные данные; 408 — сохраните исходный ключ; 413 — уменьшите тело; 415 — отправляйте application/json. Стройте логику по code, не по тексту message.

Повторы и восстановление

Idempotency-Key и защита от дублей

Защита от повторной отправки — часть интеграции, а не дополнительная опция.

  1. Одна логическая попытка — один Idempotency-Key, 8–128 ASCII-символов. UUID подходит. Сохраните ключ до первого запроса.
  2. При тайм-ауте не создавайте новый ключ. Восстановите ID чтением по исходному ключу. При неизвестном результате Perplexity используйте GET: не повторяйте POST активации и не меняйте сервис исполнения.
  3. Новая попытка и новый ключ допустимы только после конечного failed / action_required с retryable: true, исправления причины и окончания паузы.
Восстановить ID без секретов аккаунта
curl --fail-with-body 'https://subhelp.pro/api/v1/activations/by-idempotency-key' \
  --header "Authorization: Bearer $SUBHELP_API_KEY" \
  --header 'Idempotency-Key: order-10482-attempt-1'

200 вернёт сохранённую заявку и Location. Сохраните data.id и перейдите к GET /activations/{id}. После тайм-аута 404 может означать, что исходная заявка ещё сохраняется: подождите, не создавайте новую попытку.

Дайте заявке время

Проверяйте статус раз в 12 секунд или реже. retryAfterMs — миллисекунды, Retry-After — секунды; выбирайте более долгую паузу. По умолчанию — 60 запросов за фиксированную минуту на покупателя для всех методов вместе; ваш лимит может отличаться.

Безопасность и FAQ

Хранение ключей, согласия и частые вопросы

Никаких ключей в браузере, логах или клиентском приложении.

Только server-to-server

API-ключ — в серверных секретах, не в NEXT_PUBLIC_, JavaScript браузера, мобильном приложении, URL, cookie или localStorage.

Без чувствительных логов

Не логируйте Authorization, тела запросов, Session, пароли и 2FA. Шифруйте данные заказа и проверяйте доступ своих пользователей.

Согласие владельца

Не подставляйте согласие Claude и не включайте confirmOverride за пользователя. Не меняйте поставщика и не отменяйте заявку обходными путями.

Как получить ключ?

Обратитесь к продавцу SubHelp в чате своего заказа. Ключ выдаётся отдельно и может разрешать не все пять товаров. На этой странице ключи не генерируются.

Можно вызывать API прямо с сайта?

Из backend вашего сайта — да. Из JavaScript браузера — нет: это раскрывает ключ. Защитите свою серверную точку авторизацией пользователей и привязкой к их заказам.

Нужно пополнять баланс?

Нет. В API v1 используются уже купленные коды. Покупка кодов, баланс, отмена заявок и webhooks в эту версию не входят.

Какие данные отправлять в поддержку?

ID активации, requestId, товар, время с часовым поясом, HTTP-статус и безопасный code. Не отправляйте API-ключ, Session, пароль или 2FA; код покупки маскируйте.