История изменений

v3.2: Новая система заказов: один список ошибок, более простая постепенная подача, понятнее отмена и восполнение

Всё ниже выходит вместе под заголовком X-NotPanel-API-Version: 2026-10. Каждое прежнее действие продолжает работать, а адреса /api/v1, /api/v2 и /api/v3 работают одинаково.

• У каждого заказа один номер, который действует в панели, в поддержке и в API. Заказы через API сохраняют прежние номера.
• Постепенная подача: runs с interval по-прежнему работает. Новая простая форма принимает общее quantity и drip_feed_total_minutes, до 48 ч.
• Отмена мгновенная с полным возвратом в течение первых 15 с. Позже можно запросить отмену там, где услуга это поддерживает, с автоматическим возвратом. order возвращает один объект, как и раньше; orders возвращает массив.
• Восполнение работает раз в 6 ч на заказ, без конечной даты и с понятной причиной в случае отказа.
• Реакции Telegram — одно поле reactions: либо смесь (👍,❤️,🔥), либо точное количество (👍:60,❤️:40), проверяемое до списания средств.
• Список услуг показывает теги, дополнительные поля с ограничениями, ограничения постепенной подачи и доступность. cancel: true теперь означает, что запросы на отмену действительно работают.
• У каждой ошибки есть фиксированный код, HTTP-статус и признак retryable. Прежние и текущие коды перечислены ниже.
• Новое действие order_details, которое также может найти заказ по вашему request_id.
• status сразу показывает возврат: для отменённого или частичного заказа refund — это сумма возврата, отдельный вызов не нужен. refund_quote — прежнее имя, которое возвращает тот же ответ, что и status.
• Вебхуки теперь единая система: одно подписанное событие на вызов, с версией, с новыми событиями для отменённых и частичных заказов и для результатов восполнения.
• Удалено: пакетные тела вебхуков, параметр coupon, а в status — поля refund_pending и два поля политики возврата. Прежний параметр delay больше не читается; используйте drip_feed_total_minutes.
• Добавлено: can_cancel в status и instant_cancel_until в ответе add. Прежнее поле cancel_available осталось в обоих, а cancel_window_seconds и cancel_before остались в ответе add.
• Сохранено: действия catalog и account_status работают как прежде, а catalog теперь описано в разделе «Список услуг». Прежние имена параметров по-прежнему работают: referer, lpost_count, hashtag для списков хештегов, usernames через запятую и прежняя карта реакций. webhook.add также принимает имена событий order.refunded и order.refill_completed.
• /api/v1, /api/v2 и /api/v3 продолжают работать и ведут себя одинаково. Документирован /api/v3.
• У выполненного заказа remains всегда равен 0.

v3.1: Названия услуг, привычные для рынка

Действия services и catalog теперь принимают необязательный код языка для названий, локализованных с использованием отобранной рыночной терминологии на десяти языках. Явные запросы добавляют метаданные канонического имени и фактического языка и безопасно возвращаются к английскому, если перевод отсутствует или устарел. Без language старая английская структура не меняется. Администраторы могут проверить или уточнить отдельные названия.

v3.0: v3 становится API по умолчанию

/api/v3 стал канонической точкой и прямой заменой базового URL для знакомого reseller-контракта. v3 добавляет необязательные точные ключи, 60-секундную защиту старых клиентов, расширенный каталог, числовые ID, refund_quote, account_status, одиночную или последовательную пакетную отмену и подписанные webhooks. Пропускная способность API теперь зависит от lifetime successful spend и использует одно 60-секундное скользящее окно, общее для всех ключей аккаунта. /api/v1 и /api/v2 — точные псевдонимы текущего контракта.

v2.5: Расширенный каталог, сверка возврата и отмена

Добавлены постраничное действие catalog и действие refund_quote только для чтения, расширены метаданные add и status и введено окно отмены в 15 секунд для обычных заказов через API. События вебхуков API теперь содержат стабильный id события, а deliveryId остается неизменным при повторных попытках доставки того же пакета; каждая попытка получает новую временную метку и подпись. Доставка вебхуков по-прежнему выполняется по мере возможности с повторами, без долговременной гарантии доставки хотя бы один раз.

v2.4: 12 новых медиаплатформ в каталоге

Добавлены услуги для Google, Rumble, Audiomack, Tumblr, Kwai, Clubhouse, Vimeo, Deezer, Tidal, Apple Music, Quora и GitHub. Они появляются в действии services, как любая другая услуга, и у каждой есть отдельная публичная страница платформы. Изменений на стороне клиента не требуется — новые ID услуг просто появляются в каталоге.

v2.3: Доступность услуги проверяется при добавлении

Недоступные услуги отклоняют action=add вместо молчаливого принятия или постановки нового заказа в очередь. Обновите каталог и выберите доступную услугу перед повтором.

v2.2: Необязательные параметры заказа

Действие add теперь принимает поддерживаемые необязательные поля конкретного типа услуги, например задержку старта и параметры взаимодействия для типа. Поля, уже определённые типом услуги, сохраняют документированное значение.

v2.1: Параметры drip-feed при размещении заказа

Действие add принимает runs и interval вместе для услуг с dripfeed=true. Общая доставка равна quantity × runs и не может превышать максимум услуги. Услуги без drip-feed отклоняют эти поля.