Результаты запросов

Каждый request к FourA API классифицируется ровно по одному результату (outcome), как и каждый туннель через порт proxy. Outcome вычисляется один раз, в конце вызова, и записывается для учетных данных, выполнивших его. Панель управления, лента активности и биллинг считывают одно и то же поле.

Только success расходует кредиты. Премиум-трафик учитывается отдельно от кредитов и не зависит от outcome: см. Billing Implications.

Семь вариантов outcome

Вот семь вариантов, которыми может завершиться request. Туннель использует пять из них: см. раздел Tunnels Use the Same Vocabulary ниже.

Колонка уровня указывает на источник проблемы:

• Результаты target относятся к запрашиваемому сайту. Ваш request успешно дошел до FourA, а FourA успешно связался с целевым ресурсом. Ошибку вернул сам целевой сайт.
• Результаты caller означают, что request изначально содержал ошибку. Исправьте структуру и параметры запроса.
• Результаты FourA вызваны сбоем с нашей стороны. Повторите попытку и проверьте страницу статуса, если они сохраняются.

Если целевой сайт возвращает 403, это классифицируется как application_fail, а не client_error. Ваш вызов был сформирован верно. Сайт просто ответил отказом.

Успешность зависит от validate

Без validate API помечает request как success только тогда, когда целевой ресурс возвращает HTTP 200.

С validate успешность определяется заданными вами правилами. Если вы укажете API, что для данного request допустимы как 200, так и 403, то 403 вернется как success. Тело ответа при этом будет доставлено вам без изменений.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "GET",
    "url": "https://target.example/feed",
    "validate": {
      "status": { "accept": [200, 403] }
    }
  }'

В этом вызове ответ 403 считается как success и тарифицируется как один request. Ответ 500 считается как application_fail и не тарифицируется.

Та же логика применяется к validate.headers и validate.data. Любой response, который движок принимает согласно вашим правилам, возвращается как success независимо от HTTP status.

Один ответ никогда не бывает success, с validate или без него: это HTTP 200, тело которого является распознанной FourA страницей проверки на ботов, такой как визуальная CAPTCHA или страница, требующая только запуска JavaScript в браузере. Такой request получает статус application_error и не тарифицируется. Тело ответа все равно доставляется вам без изменений, а header X-FourA-Check-Page указывает тип страницы проверки.

Влияние на биллинг

Тарифицируются только те запросы, которые вернули запрошенные вами данные. Ошибки на стороне FourA, целевого ресурса или на вашей стороне бесплатны.

Таблица относится к кредитам. Премиум-трафик учитывается отдельно: request, использовавший премиум-выход, учитывает переданный этой попыткой трафик при любом исходе, так как выход был задействован в любом случае. Попытка, которая еще выполнялась, когда ответил другой выход, немедленно останавливается, и переданный ею до этого момента трафик также учитывается.

Стандартный трафик также не зависит от outcome: на тарифе с лимитом полосы трафик каждого request учитывается в квоте. Request, отклоненный одним из лимитов вашего тарифа, не расходует трафик.

Туннели используют ту же терминологию

Туннель через порт proxy также завершается одним из этих исходов, поэтому один набор меток покрывает оба продукта. Возможны только пять из семи исходов, поскольку два исхода target требуют, чтобы FourA проанализировал ответ цели, а ответ туннеля представляет собой ваш собственный зашифрованный трафик.

Отказ также сопровождается краткой причиной, и в панели управления она отображается в понятных вам терминах, а не в наших внутренних. Если опция не может быть выполнена FourA, возвращается 400 прямо на уровне соединения, и запись не создается, поэтому в этом списке она не появится вовсе.

Туннели не тарифицируются в кредитах, так как у туннеля нет request, к которому можно привязать списание. Вместо этого порт учитывает байты. См. раздел Как тарифицируется ваш план.

Анализ результатов в панели управления

Каждый request, сделанный с вашим API key, отображается в ленте Activity с меткой соответствующего исхода. Страницы Metrics и Overview агрегируют это же поле для круговых диаграмм и графиков динамики.

При фильтрации Activity по исходу можно также выбрать конкретный endpoint (Auto, Single, Proxy Finder, Browser), чтобы проверить, характерна ли ошибка для одного из них. Переключите Product на странице на Proxy, и те же фильтры исходов будут применяться к вашим туннелям.

Эвристики повторных попыток

Базовая политика retry на основе полученных исходов:

Связанные разделы

• Ошибки API: ответы с ошибками на уровне HTTP
• Порт proxy: коды состояния при отказе туннеля
• Rate Limits: что вызывает rate_limit и в каких двух форматах возвращается ответ
• Метрики: где смотреть детализацию результатов
• Журнал активности: история результатов для каждого request