Главное
Один вызов Auto теперь отображается как один request в Dashboard. Попытки Single, Proxy Finder и Browser внутри него по-прежнему видны списком под вызовом, но показатели success rate и latency теперь считаются для вашего исходного запроса. Отказы из-за лимитов тарифного плана больше не учитываются как трафик, Auto помечает такие случаи как rate limit, а на странице Billing каждое пополнение баланса вынесено в отдельную строку.
Что нового
Вызовы Auto считаются как один request
Раньше вызов Auto отображался в Dashboard как набор совершенных попыток, поэтому один URL мог выглядеть как несколько запросов, часть из которых завершилась с ошибкой. Теперь во вкладках Overview, Usage & Limits и Activity сервис Auto выделен в отдельный продукт. Каждый вызов представляет собой одну строку с единым результатом, суммой кредитов и байтов по всем попыткам, перечисленным ниже. Лимит rate limit по-прежнему учитывает каждую попытку, так как именно их выполняют движки.
Если открыть Activity сразу после вызова, в строке будет указано, что попытки еще обрабатываются. Через несколько секунд список попыток, кредиты и байты подгружаются на месте без перезагрузки страницы, поэтому просматриваемая строка никуда не смещается.
Это соответствует изначальной концепции Auto. Это инструмент поиска маршрута: найдите рабочий вариант, а затем передайте полученный session в /api/single или /api/browser и направляйте основной трафик туда. Activity показывает полный список попыток каждого вызова до того, как вы зафиксируете маршрут.
Отказы по лимитам плана: не считаются трафиком и отображаются в Auto
Request, отклоненный из-за достижения лимита вашего тарифного плана, больше не добавляется к общему объему трафика. Данные не запрашивались, поэтому учет не ведется. Ответы 403 или 500 от целевого сайта по-прежнему учитываются, так как мы доставили ответ клиенту.
Когда вызов Auto упирается в один из таких лимитов, в Activity он отображается как Rate Limited, а не как сбой, и response содержит тот же header X-FourA-Limit, что и прямой вызов:
import requests
r = requests.post(
"https://api.foura.ai/api/auto",
headers={"X-API-Key": "pk_live_..."},
json={"url": "https://example.com/data"},
)
limit = r.headers.get("X-FourA-Limit")
if limit:
print("stopped by my plan:", limit)
else:
session = r.json().get("session") # replay on /api/single or /api/browser
Еще один ответ теперь точно сообщает о том, что произошло. Целевой ресурс, чье имя хоста не резолвится, возвращается из Single, Browser, Proxy Finder и Auto так же, как и любой недоступный сайт: status 0, ошибка с указанием хоста и статус выполнения (application_fail, см. outcomes). Ресурсы в приватных сетях по-прежнему получают отказ 400.
Трафик в единой системе измерения
Мы зафиксировали точный размер гигабайта: 1 073 741 824 байта для всех лимитов и счетчиков. API трафик рассчитывается по декодированной странице, так как именно ее мы отдаем клиенту, независимо от того, потребовался ли реальный браузер или дополнительный шаг по требованию страницы. Трафик через порт proxy учитывается при прохождении через туннель, где мы лишь передаем соединение, не меняя его содержимое. Это определение указано в Dashboard рядом со значениями трафика, а полный метод описан в How Your Plan Is Metered.
Значения трафика отображаются в гигабайтах везде, где рядом установлен лимит в гигабайтах, что позволяет напрямую сопоставить текущий объем с порогом. На странице Limits появился блок Traffic (общий, API, порт proxy и premium, каждый с прогресс-баром при наличии лимита в тарифе), в таблице API-ключей появились колонки Traffic и Premium, а каждый блок продукта в Overview теперь отображает свой собственный трафик.
Достигнутый лимит теперь выделяется красным статусом At limit, так как следующий request будет отклонен. Лимит на количество объектов (например, API-ключей) при достижении максимума отображается желтым цветом: он лишь блокирует добавление новых элементов.
Биллинг: четыре карточки и детализация пополнений
Страница Billing page отображает одинаковые четыре карточки на всех тарифах: сначала кредиты или стандартный трафик (в зависимости от основы тарифа), затем вторую метрику, Premium и Proxy port. На каждой карточке есть кнопка Buy. Если тариф не предусматривает покупку конкретной позиции, кнопка сообщает об этом и предлагает связаться с нами.
На платном тарифе с оплатой по кредитам порт proxy включает собственный объем гигабайтов, а докупить трафик можно прямо из соответствующей карточки. Каждое пополнение отображается отдельной строкой с указанием купленного объема, использованного остатка и доступного баланса. Списание идет с пополнения, срок действия которого истекает раньше.
Уведомления об использовании трафика также стали более информативными. При достижении 95% вы получаете письмо с расчетом дня исчерпания лимита при текущей динамике относительно даты сброса, а также действие для его увеличения. Письмо при 100% сообщает, сколько дней осталось до сброса, а для тарифов с перерасходом указывает стоимость дополнительного объема.
MCP 0.7.3
В FourA MCP 0.7.3 схемы инструментов приведены в соответствие со спецификациями JSON Schema draft-07 и 2020-12, поэтому клиенты со строгой валидацией по 2020-12 могут получать список и вызывать все четыре инструмента. Параметры вызовов не изменились. Обновите @fouradata/mcp или используйте размещенный сервер, который уже работает на версии 0.7.3.
Документация и сайт
- Выберите результат в поиске docs, и страница прокрутится к первому вхождению слова с его подсветкой. Верхний результат выбирается сразу при появлении выдачи, поэтому Enter сразу открывает его.
- На смартфонах и планшетах меню основного сайта открывается в момент отрыва пальца от экрана и заполняет его в две колонки, а каждая страница отрисовывается со всеми стилями уже на первом кадре.
Под капотом
Новые мощности Proxy Finder теперь сразу используют данные о хостах, накопленные существующими узлами. Время ответа (response time) остается стабильным при подключении новых мощностей, а не выравнивается в течение первых минут работы под вашей нагрузкой.
Каждое число в вашем Dashboard должно соотноситься с конкретным действием вашей задачи. Если для понимания источника метрики требуются калькулятор и документация, это наша задача исправить отображение числа, а не ваша разбираться в нем.