Как тарифицируется ваш план
FourA продает два продукта, и они измеряются в разных единицах. Ваш тариф привязан к одной из этих двух единиц, что определяет лимит и карточки в панели управления. На этой странице вся модель представлена на одном экране.
Два продукта, две единицы измерения
| Продукт | Вы вызываете | Единица измерения |
|---|---|---|
| API | POST /api/single, /api/proxy, /api/browser, /api/auto |
Запрос, тарифицируемый в кредитах |
| Proxy port | proxy.foura.ai:34004 из любого клиента, принимающего URL прокси |
Туннель, тарифицируемый в гигабайтах |
В API только результат success расходует кредиты. Запрос, завершившийся ошибкой на стороне цели, на вашей стороне или на нашей, не стоит ничего. Премиум трафик учитывается отдельно от кредитов, как описано ниже. См. Request Outcomes.
На proxy port нет кредитов и подсчета запросов, и это не упущение. Туннель представляет собой одно соединение, открываемое вашим инструментом, а данные внутри являются вашим собственным зашифрованным трафиком, поэтому FourA может учитывать только сам туннель и переданные байты. Подсчет запросов здесь был бы числом, которое вы никогда не смогли бы сопоставить со своими логами. Поэтому порт всегда продается с оплатой за гигабайт. См. Proxy Port.
Что такое гигабайт и что в него входит
Один гигабайт равен 1 073 741 824 байтам (2^30, единица также обозначается как GiB). Каждый лимит, счетчик и тариф в вашем плане использует именно это значение, как для API, так и для proxy port.
Учитываемый объем различается в зависимости от продукта, так как они передают разные данные:
| Где | Что учитывается |
|---|---|
| API, стандартные выходы | Тело запроса, отправленного нам, плюс тело ответа, который мы возвращаем. Заголовки HTTP не учитываются ни с одной стороны. |
| API, премиум выходы | Каждый байт передачи данных по сети в обоих направлениях в сжатом и зашифрованном виде. |
| Proxy port | Каждый байт, проходящий через туннель в обоих направлениях после его открытия, включая установку зашифрованного соединения клиентом с сайтом. Открытие туннеля не учитывается, за исключением случаев, когда премиум выход, опробованный портом и не использованный при открытии туннеля, считается премиум трафиком. |
Несколько важных выводов:
- Страница тарифицируется в декодированном виде, поскольку именно декодированную страницу мы отдаем. Чтобы получить ее, может потребоваться запуск реального браузера, выполнение дополнительных действий по требованию страницы, декодирование ответа и предоставление вам готового к использованию контента. Вы платите за этот результат, а не за то, насколько компактно передавались данные. Порт proxy работает иначе и рассчитывается по другой модели: там мы пропускаем ваше собственное соединение и никак не вмешиваемся в его содержимое, поэтому байты считаются строго так, как они проходят через туннель.
- Повторные попытки в стандартном пуле бесплатны. Когда Proxy Finder перебирает несколько выходных узлов, вы платите один раз за полученный ответ, независимо от числа попыток. На премиум-узле учитывается каждая попытка, так как именно так выставляют счета премиум-сети.
- Браузерная сессия через стандартный узел тарифицируется как обычный ответ API: учитывается возвращаемое тело ответа, а не каждый подресурс, загруженный страницей. Через премиум-узел учитывается весь сетевой трафик сессии.
- Премиум-трафик входит в общий объем, а не добавляется поверх него. Из стандартного лимита списывается только та часть, которая не проходила через премиум-узел.
- Вызов Auto сам по себе не генерирует трафик. Запросы Single, Proxy Finder и Browser, которые он инициирует, тарифицируются так, как если бы вы выполняли их напрямую.
- Отказ со стороны целевого сайта тарифицируется, отказ со стороны лимитов вашего тарифа нет. Если сайт возвращает 403, 404, 429 или 5xx, мы доставили вам этот ответ, поэтому он засчитывается. Если запрос отклонен из-за лимитов вашего тарифа, данные не запрашиваются и ничего не списывается.
- Никаких округлений в большую сторону. Байты подсчитываются точно, без фиксированного размера блока и без минимального порога на request, а ваши показатели еженощно сверяются с нашим хранилищем метрик.
Две модели тарификации планов
Оба счетчика работают для каждого аккаунта. Разница лишь в том, по какой модели продается ваш тариф.
Тарификация по кредитам
API списывает кредиты за каждый тарифицируемый request. Для порта proxy выделяется собственный включенный объем гигабайтов с отдельной квотой, поскольку в туннеле нет понятия отдельного request для списания кредита. Эти лимиты не пересекаются: трафик API не расходует гигабайты порта, а туннели порта не тратят ваши кредиты. Иначе один запрос к API тарифицировался бы дважды: сначала в кредитах, затем в байтах, которые эти кредиты сгенерировали.
Ограничение по трафику для самого API отключено, если оно явно не предусмотрено вашим планом.
Тарификация по трафику
Единый лимит стандартного трафика покрывает и API, и порт proxy, так как обе точки входа тарифицируются в одних единицах. План с такой моделью не списывает кредиты, поэтому они полностью скрыты из панели управления, чтобы не отображать нерелевантные значения.
Премиум-трафик в обеих моделях
Премиум-трафик всегда имеет отдельный лимит в любом типе плана. Он никогда не включается в стандартный объем, поэтому один и тот же гигабайт никогда не списывается дважды. Выход на премиум-узел настраивается через exitClass: premium в POST /api/proxy/ или POST /api/auto/, либо через -network-premium на порту proxy.
Трафик измеряется при прохождении через сеть: в обоих направлениях, с учетом сжатия и шифрования. В API учитывается каждая попытка premium, включая ту, которая не вернула вашу страницу. На порту proxy учитывается трафик каждого premium туннеля, а также любой premium выход, к которому порт пытался подключиться и сбросил при открытии.
Что и где отклоняет запросы
| Лимит | В API | На порту proxy |
|---|---|---|
| Кредиты за период | 429 с X-FourA-Limit: plan_limit_credits |
Не применимо |
| Стандартный трафик за период | 429 с X-FourA-Limit: plan_limit_bandwidth |
429 с X-Foura-Error с указанием трафика |
| Одновременно открытые туннели | Не применимо | 429 с X-Foura-Error |
| Открытия туннелей в минуту | Не применимо | 429 с X-Foura-Error |
| Premium трафик | Понижается на exitClass: premium; закрепленный premium proxy ID получает 400; Proxy request с указанием exit location получает 403 с plan_limit_premium |
403 при явном запросе |
У CONNECT нет тела для передачи ошибки в JSON, поэтому отказ на порту возвращается как статус плюс header, а не в формате, описанном в Rate Limits. Читайте X-Foura-Error в первую очередь при любом подключении к proxy.
Исчерпание premium это единственная асимметрия
Две точки входа намеренно отвечают по-разному, поскольку ситуации "я запросил списание" и "параметр был задан заранее" принципиально различаются.
В API исчерпание лимита premium не блокирует запрос, запрашивающий exitClass: premium. Запрос обрабатывается из стандартного пула, а в ответе указывается exitClass: standard, чтобы вы видели, что именно получили. Единственное исключение это запрос POST /api/proxy/ с указанием exit location: стандартный пул не может его выполнить, поэтому он отклоняется с кодом 403 и plan_limit_premium. С premium proxy ID, закрепленным через proxy в последующем запросе, ситуация иная: после исчерпания лимита он отклоняется с кодом 400 и Managed exit: this proxy id cannot be pinned to a request, а новый вызов POST /api/proxy/ возвращает стандартный выход для закрепления. Тарифный план, вообще не включающий premium выходы, дает другой ответ: 403 с plan_limit_premium.
На порту proxy:
- Подключение с указанием
-network-premiumотклоняется с кодом403. Вы явно запросили списание, поэтому тихий перевод на другой ресурс оставил бы вас с расхождением в учете premium строки, которой нет. - Значение premium по умолчанию, сохраненное для proxy пользователя, понижается до общей сети, и туннель все равно открывается. Вы не выбирали его явно для этого подключения.
- Взведенный
-fallback-premiumпросто не срабатывает.
Покупка дополнительного объема
Пакеты пополнения расходуются точно так же, как и лимиты из тарифного плана. В каждом периоде сначала используется включенный объем плана, и только перерасход списывается с купленного баланса. Срок действия покупки составляет двенадцать месяцев.
Панель управления разделяет эти два значения везде, где указывается лимит (1,300,000 (300,000 incl + 1,000,000 bought)), поэтому цифры на экране можно сопоставить со счетом на руках.
Где смотреть свои показатели
| Страница | За что отвечает |
|---|---|
| Billing | Текущий период в сравнении с доступным остатком, по одной карточке на каждую тарифицируемую метрику плана, с кнопкой «Купить» на карточках, доступных для пополнения |
| Usage & Limits | Все лимиты рядом с актуальными счетчиками, а также детализация по ключам, endpoint и пользователям proxy |
| Overview | Объем и трафик за любой период с разбивкой по продуктам |
Отображение карточек в разделе Billing зависит от двух описанных выше сценариев. Тариф с оплатой по кредитам содержит карточку Credits, а его карточка Proxy port traffic показывает включенные гигабайты самого порта. Тариф с оплатой по трафику вместо Credits содержит карточку Requests, карточка Proxy port traffic отображает объем, переданный портом из общего пула, а карточка Standard traffic содержит общий лимит с пометкой The API and the proxy port together.
Не фиксируйте эти значения жестко в коде. Каждый отказ API содержит лимит, вызвавший ограничение, а при отказе порта он указывается в X-Foura-Error.
Связанные разделы
- Rate Limits: все тела ответов и заголовки лимитов тарифа в API
- Proxy Port: тарификация, коды ответов и параметры имени пользователя
- Request Outcomes: тарифицируемые результаты для request и туннелей
- Billing & Subscriptions: тарифы, пополнения и счета
- Usage & Limits: текущие счетчики в сравнении с лимитами плана