Ломающие и заметные изменения в API v3. Мы следуем semver — аддитивные изменения (новые необязательные параметры, новые действия, новые поля в ответах) выходят в рамках мажорной версии; ломающие изменения идут в новую мажорную.
Действия services и catalog теперь принимают необязательный код языка для названий, локализованных с использованием отобранной рыночной терминологии на десяти языках. Явные запросы добавляют метаданные канонического имени и фактического языка и безопасно возвращаются к английскому, если перевод отсутствует или устарел. Без language старая английская структура не меняется. Администраторы могут проверить или уточнить отдельные названия.
/api/v3 стал канонической точкой и прямой заменой базового URL для знакомого reseller-контракта. v3 добавляет необязательные точные ключи, 60-секундную защиту старых клиентов, расширенный каталог, числовые ID, refund_quote, account_status, одиночную или последовательную пакетную отмену и подписанные webhooks. Пропускная способность API теперь зависит от lifetime successful spend и использует одно 60-секундное скользящее окно, общее для всех ключей аккаунта. /api/v1 и /api/v2 — точные псевдонимы текущего контракта.
Добавлены постраничное действие catalog и действие refund_quote только для чтения, расширены метаданные add и status, введено окно отмены в 15 секунд для обычных заказов через API и полный возврат по обычному заказу, остающемуся неразрешенным через 7 дней после первоначального создания. События вебхуков API теперь содержат стабильный id события, а deliveryId остается неизменным при повторных попытках доставки того же пакета; каждая попытка получает новую временную метку и подпись. Доставка вебхуков по-прежнему выполняется по мере возможности с повторами, без долговременной гарантии доставки хотя бы один раз.
Добавлены услуги для Google, Rumble, Audiomack, Tumblr, Kwai, Clubhouse, Vimeo, Deezer, Tidal, Apple Music, Quora и GitHub. Они появляются в действии services, как любая другая услуга, и у каждой есть отдельная публичная страница платформы. Изменений на стороне клиента не требуется — новые ID услуг просто появляются в каталоге.
Недоступные услуги отклоняют action=add вместо молчаливого принятия или постановки нового заказа в очередь. Обновите каталог и выберите доступную услугу перед повтором.
Действие add теперь принимает поддерживаемые необязательные поля конкретного типа услуги, например задержку старта и параметры взаимодействия для типа. Поля, уже определённые типом услуги, сохраняют документированное значение.
Действие add принимает runs и interval вместе для услуг с dripfeed=true. Общая доставка равна quantity × runs и не может превышать максимум услуги. Услуги без drip-feed отклоняют эти поля.
Запущен API действий v2 с form-encoded запросами, контролем частоты, подписанными best-effort вебхуками с повторами и идемпотентным размещением заказов. Текущие URL v1 и v2 являются псевдонимами контракта v3 и используют документированный общий лимит аккаунта.