Документация, которую можно сразу использовать в работе.
Здесь нет мертвых заголовков и фальшивых ссылок. Каждый блок ведет дальше: в сервис, сценарий, доступ или кабинет.
С чего начать
1. Создайте аккаунт и получите токен.
2. Откройте страницу нужного сервиса.
3. Возьмите готовый JSON-блок для Creatium или CreMax.
4. Проверьте вызов на своей задаче.
Разделы
Быстрый старт
Регистрация, токен и первый рабочий вызов API.
Сценарии и JSON-блоки
Готовые примеры под Creatium и CreMax без лишней ручной сборки.
IMG API
Сжатие, форматы, ограничения и проверка результата на живом примере.
MAX API
Передача удаленного файла в Max единым вызовом.
Токены и доступ
Trial-лимиты, доменные подключения и дальнейшие тарифы.
Личный кабинет
Токены, лимиты и рабочие данные по своему аккаунту.
Токены и доступ
Публичные API уже работают по токену из кабинета.
После регистрации вы получаете токен платформы. Его и нужно передавать в `Authorization: Bearer ...` при вызове `IMG API` и `MAX API` на `helpers.nchub.studio`.
Старт
Сразу после регистрации у токена есть по 10 тестовых запросов на каждый API.
Дальше
Кабинет показывает расход лимита, успешные вызовы, ошибки и последние коды ответов по каждому сервису.
Важно
Для `domain`-подписок дополнительно проверяется домен запроса по `Origin` или `Referer`.
Пример запроса
Для Creatium и CreMax токен передается в обычном заголовке Authorization.
Ниже рабочий JSON-блок для `IMG API`. Токен храните в своей переменной и подставляйте в заголовок, а не в тело запроса.
IMG API
Готовый JSON-блок сценария
Рабочая основа для вызова через токен из кабинета.
{ "scenario_editor": "0.13", "scenario_blocks": [ { "key": "img_resize", "type": "HttpRequest", "data": { "variable": "img_result", "url": "\"https://helpers.nchub.studio/api/v1/img/resize\"", "method": "POST", "content_type": "application/json", "headers": [ { "key": "Authorization", "value": "\"Bearer \" & token" } ], "body": [], "body_expr": "{\n \"url\": \"https://example.com/image.jpg\",\n \"sizes\": [200, 400, 800],\n \"mode\": \"auto\",\n \"wm\": \"UNIUM\"\n}", "timeout": "0" }, "logs": [] } ]}Коды ответов
200 или 2xx — сервис обработал запрос.
401 — токен не передан или не найден.
403 — лимит исчерпан, сервис не подключен или домен не разрешен.
4xx/5xx от сервиса — запрос дошел до микросервиса, но сам вызов завершился ошибкой валидации или обработки.
Пример ошибки
Как выглядит ответ при остановке по лимиту
Такие ответы тоже попадают в статистику кабинета вместе с кодом и текстом ошибки.
{ "error": "Trial limit reached for this service"}Сервисы и их страницы