/productsСписок товаров, разрешённых вашему ключу, и полей account.
Активация купленных кодов на вашем сайте.
https://subhelp.pro/api/v1Откройте только то, что нужно сейчас.
ChatGPT, Claude, Perplexity, Google AI Pro и Duolingo
Выберите сервис. Меняются только product и данные account.
Полная актуальная Session аккаунта как JSON-строка. Не отдельный токен и не email. Получайте её только от владельца аккаунта.
sessionобязательно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/v1. Только запуск отправляет активацию.
/productsСписок товаров, разрешённых вашему ключу, и полей account.
/codes/checkНерасходующая проверка кода там, где она поддерживается. valid: null — доступность не подтверждена.
/activationsЗапуск с обязательным Idempotency-Key. 202 — ожидание; 200 — конечный результат. Сохраните data.id.
/activations/by-idempotency-keyВосстановление ID по исходному Idempotency-Key, без Session, пароля или 2FA. Поставщик не вызывается.
/activations/{id}Текущий результат вашей заявки. HTTP 200 возможен и при processing / review. Новый запуск не выполняется.
Для SSOP проверка читает остаток активаций, а для G12 — реальную текущую доступность без расходования и без раскрытия внутреннего состояния. Для M6 / M12 / M24 и Perplexity PXY / PXY2 проверяется только формат. Ответ valid: null с кодом code_format_valid не подтверждает доступность.
Как обработать ответ и показать результат
ok: true означает, что запрос обработан. Подписка активна только при data.status: completed.
{
"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 | Покажите необходимое действие. Если причина неясна — обратитесь в поддержку. |
401 · unauthorizedПроверьте серверный API-ключ и его доступность.
403 · product_not_allowedЗапросите у SubHelp доступ к нужному продукту.
408 · request_timeoutJSON не получен за 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 и защита от дублей
Защита от повторной отправки — часть интеграции, а не дополнительная опция.
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 запросов за фиксированную минуту на покупателя для всех методов вместе; ваш лимит может отличаться.
Хранение ключей, согласия и частые вопросы
Никаких ключей в браузере, логах или клиентском приложении.
API-ключ — в серверных секретах, не в NEXT_PUBLIC_, JavaScript браузера, мобильном приложении, URL, cookie или localStorage.
Не логируйте Authorization, тела запросов, Session, пароли и 2FA. Шифруйте данные заказа и проверяйте доступ своих пользователей.
Не подставляйте согласие Claude и не включайте confirmOverride за пользователя. Не меняйте поставщика и не отменяйте заявку обходными путями.
Обратитесь к продавцу SubHelp в чате своего заказа. Ключ выдаётся отдельно и может разрешать не все пять товаров. На этой странице ключи не генерируются.
Из backend вашего сайта — да. Из JavaScript браузера — нет: это раскрывает ключ. Защитите свою серверную точку авторизацией пользователей и привязкой к их заказам.
Нет. В API v1 используются уже купленные коды. Покупка кодов, баланс, отмена заявок и webhooks в эту версию не входят.
ID активации, requestId, товар, время с часовым поясом, HTTP-статус и безопасный code. Не отправляйте API-ключ, Session, пароль или 2FA; код покупки маскируйте.