API активации для разработчиков

Публичный endpoint:

https://hmmml.ru/api/redeem

У API два действия: check проверяет код без списания, activate активирует код на нужный аккаунт. Провайдеры, остатки CDK и внутренние детали наружу не отдаются.

1. Получите HMMML-код от покупателя.
2. Вызовите check и определите тариф по plan.
3. Запросите у покупателя нужные данные аккаунта для этого тарифа.
4. Вызовите activate один раз и дождитесь ответа.
5. Если ответ pending или соединение оборвалось после отправки, не запускайте activate повторно. Опрашивайте status endpoint с тем же HMMML-кодом.

Для action=check корректный запрос возвращает HTTP 200 даже для недействительного кода: проверяйте поле valid, а машинную причину берите из errorCode.

curl -X POST https://hmmml.ru/api/redeem \
  -H "Content-Type: application/json" \
  -d '{"action":"check","code":"HMMML-XXXX-XXXX-XXXX-XXXX"}'

{
  "success": true,
  "valid": true,
  "plan": "GROK_PRO_1M",
  "planName": "SuperGrok CDK 1 месяц"
}

{
  "success": true,
  "valid": false,
  "errorCode": "INVALID_CODE",
  "reason": "not_found",
  "message": "Code not found"
}

Для ChatGPT нужен полный JSON со страницы https://chatgpt.com/api/auth/session.

ChatGPT активируется только на личный профиль Personal без активной подписки. Team / Workspace Session JSON блокируется до резервирования CDK.

curl -X POST https://hmmml.ru/api/redeem \
  -H "Content-Type: application/json" \
  -d '{
    "action": "activate",
    "code": "HMMML-XXXX-XXXX-XXXX-XXXX",
    "sessionData": { "...": "full ChatGPT session JSON object" }
  }'

Для Claude нужен Organization ID.

{
  "action": "activate",
  "code": "HMMML-XXXX-XXXX-XXXX-XXXX",
  "claudeOrgId": "00000000-0000-0000-0000-000000000000"
}

Для Grok нужен полный Session JSON и обязательное поле grokNoActiveSubscriptionConfirmed=true. Это подтверждение интегратора: при активной подписке CDK может быть потрачен без продления. Необязательный grokSubscriptionData включает дополнительную строгую проверку.

{
  "action": "activate",
  "code": "HMMML-XXXX-XXXX-XXXX-XXXX",
  "grokUserId": "{"status":"authenticated","session":{"userId":"00000000-0000-0000-0000-000000000000"}}",
  "grokNoActiveSubscriptionConfirmed": true
}

Для Perplexity нужен полный JSON со страницы https://www.perplexity.ai/api/user.

{
  "action": "activate",
  "code": "HMMML-XXXX-XXXX-XXXX-XXXX",
  "perplexityUserJson": { "...": "full Perplexity user JSON object" }
}

Успешный ответ:

{
  "success": true,
  "operationId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Subscription activated",
  "email": "target@example.com"
}

Асинхронный ответ:

HTTP/1.1 202 Accepted
{
  "success": false,
  "error": "PENDING_VERIFICATION",
  "uniquecode": "code_HMMML-XXXX-XXXX-XXXX-XXXX",
  "operationId": "550e8400-e29b-41d4-a716-446655440000",
  "retrySafe": false,
  "message": "Activation is still being confirmed"
}

Используйте status endpoint после HTTP 202 или потери ответа. Передавайте исходный HMMML-код в JSON-теле не чаще одного раза в 10 секунд; endpoint только читает сохранённое состояние и не обращается к провайдерам.

curl -X POST https://hmmml.ru/api/activation-status   -H "Content-Type: application/json"   -d '{"code":"HMMML-XXXX-XXXX-XXXX-XXXX"}'

{
  "status": "pending | completed | retryable | failed | not_found",
  "error": "optional_machine_code",
  "message": "Human-readable status"
}

• Вызывайте API только со своего backend. CORS для браузерных вызовов намеренно не включён.
• HMMML-код является платёжным bearer-секретом. Не храните его в клиентском JavaScript, не передавайте в query string и не публикуйте в URL или логах.
• ChatGPT Session JSON содержит access token. Не записывайте его в логи, аналитику, чаты, exception-трекеры или постоянную базу.
• Максимальный размер JSON-запроса — 512 KiB. Клиентский timeout для activate должен быть не меньше 5 минут.
• Повторяйте activate только когда retrySafe=true. При pending или неизвестном исходе используйте status endpoint либо поддержку.

• Один код можно активировать только один раз.
• Не отправляйте один и тот же код параллельно из нескольких воркеров.
• Не повторяйте uncertain/pending активацию на другом аккаунте.
• Не показывайте покупателю провайдеров, CDK и внутренние ошибки.
• У API есть rate limit. Коротко кешируйте результат check на своей стороне.
• Для поддержки передавайте HMMML-код, план, время запроса и error code.