GET/account
Состояние тарифа и квот
Инструмент MCP: hooksis_account_status
Тариф, язык тарифа, остаток сборов, дата сброса, срок доступа, активные сборы (идущие и готовые в пределах 24 часов) с прогрессом и other_plans — возможности, которых нет в тарифе, с тарифом, где каждая есть. notice называет ожидание словами (минуты и часы): у каждого идущего сбора и у нового сбора, если сбор есть в остатке; та же оценка приходит в notice ответа запуска сбора. Работает без тарифа и с истёкшим тарифом: тогда в ответе только notice, а у закончившегося доступа ещё feedback_form_url — ссылка анонимной формы отзыва. Не тратит сбор и суточный лимит.
Пример запроса
curl -sS -X GET "https://app.hooksis.ru/api/v1/account" \ -H "Authorization: Bearer hk_…"
Ответы
- 200
Состояние аккаунта.
Тело →
AccountПоля ответа 200
planPlanplan_languagestringЯзык тарифа Пульс (ISO 639-1), по умолчанию
ru; закреплён за аккаунтом.quotaQuotaresets_atstring (date)Дата сброса сборов (Москва). Только подписки.
expires_atstring (date-time)Конец доступа: подписка — месяц от оплаты, Полный отчёт — 7 дней от оплаты.
active_collectionsCollectionBrief[]Идущие сборы и готовые в пределах 24 часов.
recent_failuresRecentFailure[]Упавшие за последние 24 часа сборы и поиски трендов ниш аккаунта, свежие первыми (до пяти каждого вида). Провал, после которого по той же теме или нише запускался новый сбор или поиск, не показывается: его заменил новый запуск. Упавший сбор не списан, упавший поиск трендов не засчитан в лимит новых ниш; оба запускаются заново сразу. Поле есть, когда такие провалы есть;
noticeназывает их словами.feedback_form_urlstring (uri)Ссылка анонимной формы отзыва (4 вопроса, без имени и почты) — только когда доступ закончился, то есть тариф или бета истекли. Та же ссылка, что в
notice; действует 30 суток.other_plansOtherPlan[]Возможности, которых нет в тарифе, и тариф, где каждая есть. Строка называет только тариф, который сохраняет всё из текущего: каждый инструмент и поле ответа, квоты одного сбора (языки, период, ролики, примеры тренда) не ниже. Возможность — первый по старшинству такой тариф; квота — каждый такой тариф, поднимающий её выше. Число сборов сравнивается внутри одной модели покупки: подписки — «в месяц», Полный отчёт — «на покупку». Выводится из тех же правил, что решают доступ; строка возможности инструмента начинается текстом
details.whatотказаPLAN_FEATURE_UNAVAILABLEи называет тот же тариф, чтоdetails.nearest. У Полного отчёта массив пустой: HTML-отчёт есть только в нём.noticeNotice
Пример ответа 200: Пульс: идёт один сбор
{ "plan": "pulse", "plan_language": "ru", "quota": { "used": 1, "left": 2, "limit": 3, "resets_at": "2026-11-08" }, "active_collections": [ { "collection_id": "3f6c1d2e-8a4b-4c5d-9e7f-1a2b3c4d5e6f", "topic": "уход за кудрявыми волосами", "languages": [ "ru" ], "period_days": 7, "status": "running", "progress": 40, "eta_sec": 400 } ], "resets_at": "2026-11-08", "expires_at": "2026-11-08T00:00:00+03:00", "notice": "Сбор «уход за кудрявыми волосами» идёт, ожидание — около 7 минут. Новый сбор займёт около 3 часов", "other_plans": [ { "feature": "сколько авторов сняли тренд, свободен ли он, своя ниша или общий (охват тренда)", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "сюжет и драматургия роликов", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "типы сцен роликов", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "предметы в кадре", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "ниши роликов", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "сравнение с нормой автора", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "момент хука и появления продукта", "plan": "studio", "plan_title": "Студия" }, { "feature": "темп смены планов", "plan": "studio", "plan_title": "Студия" }, { "feature": "покадровая раскладка видеоряда", "plan": "studio", "plan_title": "Студия" }, { "feature": "проверка тренда — подтверждён ли он, можно ли ему верить", "plan": "studio", "plan_title": "Студия" }, { "feature": "HTML-отчёт по сбору для клиента", "plan": "report", "plan_title": "Полный отчёт" }, { "feature": "до 3 языков в одном сборе", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "все языки в одном сборе", "plan": "studio", "plan_title": "Студия" }, { "feature": "период сбора до 30 дней", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "до 300 роликов в сборе", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "до 500 роликов в сборе", "plan": "studio", "plan_title": "Студия" }, { "feature": "все ролики-примеры тренда", "plan": "razbor", "plan_title": "Разбор" }, { "feature": "4 сбора в месяц", "plan": "razbor", "plan_title": "Разбор" } ] }
Ошибки
- 401
UNAUTHORIZED - 503
SERVICE_UNAVAILABLE