Резултати от заявки

Всяка заявка към FourA API се класифицира в точно един краен резултат, както и всеки тунел през порта за proxy. Резултатът се изчислява веднъж, в края на извикването, и се записва към идентификационните данни, които са го направили. Вашето табло за управление, потокът от активност и фактурирането четат едно и също поле.

Само success струва кредити. Премиум трафикът се отчита отделно от кредитите и не зависи от изхода: вижте Влияние върху фактурирането.

Седемте крайни резултата

Това са седемте резултата, с които може да завърши една заявка. Един тунел използва пет от тях: вижте Тунелите използват същата терминология по-долу.

Резултат Слой Какво означава
success n/a Доставен е валиден отговор. Отчита се към платимата ви квота.
application_error target Целта върна HTTP 200, но тялото съдържаше поле за грешка, или тялото е страница за проверка за ботове или отказ, която FourA разпознава.
application_fail target Целта върна статус, различен от 200, който вашите validate правила не приеха или за който не сте изпратили validate, или изобщо нямаше отговор, включително име на целеви хост, което не може да бъде резолвнато.
client_error caller Вашата заявка беше отхвърлена, преди да напусне FourA. Невалидни параметри, неправилна proxy стойност, SSRF-защитено URL.
rate_limit FourA Заявката беше отказана преди изпълнението: от някой от лимитите на вашия план (403 за endpoint или параметър, който планът не включва, 429 за изчерпан лимит), или от споделения лимит на платформата за RPM или едновременност.
service_error FourA Системата отговори със сървърна грешка или тялото не беше валиден JSON.
service_fail FourA Възникна повреда в собствената мрежа на FourA: нейната система не отговори навреме, връзката прекъсна или вие прекратихте връзката.

Колоната за слой показва кой носи отговорност:

  • target резултатите се отнасят за сайта, който сте извикали. Заявката ви достигна успешно до FourA, а FourA достигна успешно до целта. Самата цел върна грешка.
  • caller резултатите означават, че заявката ви изобщо не е имала шанс. Коригирайте формата на заявката.
  • FourA резултатите са по наша вина. Опитайте отново и проверете страницата за статус, ако те продължават.

Целеви сайт, който връща 403, е application_fail, а не client_error. Вашето извикване беше правилно оформено. Сайтът просто отказа.

Как изглежда неуспешно извикване

Извикване, което е достигнало FourA и се е изпълнило, се връща като HTTP 200, независимо какво се е случило след това. Само отказ преди извличането (400, 401, 403, 413, 429) или повреда от страна на FourA (5xx) използва друг HTTP статус. Следователно крайният резултат се чете от тялото, а не от транспортния статус.

Тяло Какво се случи Резултат
status: 200, headers, data, без error Страницата беше доставена. success
status, различен от 200, headers, data, без error Целевият сървър отговори и не изпратихте validate. Отговорът му е в data. application_fail
status, различен от 200, headers, data и error Целевият сървър отговори и вашите validate правила го отхвърлиха, например Status 404 is not in accept list 200. application_fail
status: 200, headers, data и error Целевият сървър отговори с HTTP 200 и вашите validate правила го отхвърлиха, например Data not in accept list ["product"]. application_error
Само error и total_time, без status, без data Целевият сървър изобщо не отговори с HTTP: лимитът за пренасочвания беше достигнат (Number of redirects hit maximum amount), връзката или четенето изтекоха по време, връзката беше рестартирана или отговорът беше празен. Текстът съдържа собствената причина на двигателя. application_fail
status: 0 и error, нищо друго Името на хоста не може да бъде резолвано: could not resolve <host>: <reason>. Не е стартиран двигател, а при Auto няма meta. Повторният опит няма да промени нищо, докато не се промени DNS. application_fail

Цикъл от пренасочвания, както се вижда от петия ред:

{
  "error": "Number of redirects hit maximum amount",
  "total_time": 0.808
}

При POST /api/proxy/ повикване, което изчерпи опитите, съдържа error: Download maxTry limit reached и attemptReport с броячите (вижте API Errors). При POST /api/auto/ стълбица, която се е изпълнила и е неуспешна, съдържа status, error, attempts, attemptReport с причините и meta.rung със стойност fail.

X-FourA-Credits отчита извършената работа, включително при грешка. Таксуването отчита само success, така че нито един от неуспешните формати по-горе не се таксува.

Успехът отчита validate

Без validate API маркира даден request като success само когато целта върне HTTP 200.

С validate успехът следва правилата, които сте дефинирали. Ако зададете на API, че 200 и 403 са приемливи за даден request, код 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 и се таксува като една заявка. Отговор 500 се счита за application_fail и не се таксува.

Същата логика се прилага за validate.headers и validate.data. Всеки отговор, който енджинът приеме според вашите правила, се връща като success независимо от HTTP статуса.

Един резултат никога не е success, със или без validate: HTTP 200, чието тяло е страница за проверка за ботове, която FourA разпознава, като например задача за визуална верификация или страница, която само изисква от браузъра да изпълни JavaScript, или страница с отказ, която сайтът връща с HTTP 200. Тази заявка е application_error и не се таксува. Тялото все пак достига до вас непроменено, а хедърът X-FourA-Check-Page посочва страницата.

Последици за таксуването

Outcome Billable Counts toward quota
success Да Да
application_error Не Не
application_fail Не Не
client_error Не Не
rate_limit Не Не
service_error Не Не
service_fail Не Не

Таксуват се само заявки, които са доставили поисканите от вас данни. Неуспешните заявки от страна на FourA, от страна на целта или от ваша страна са напълно безплатни.

Таблицата се отнася за кредити. Премиум трафикът се отчита отделно от тях: заявка, която е опитала premium exit, отчита трафика, пренесен от този опит, независимо от резултата, защото изходът е бил използван и в двата случая. Опит, който все още се е изпълнявал, когато друг изход е отговорил, се спира незабавно, а трафикът, пренесен до този момент, също се отчита.

Стандартният трафик също не зависи от резултата: при план с лимит на трафика, трафикът на всяка заявка се отчита към него. Заявка, отказана от някое от ограниченията на вашия собствен план, не отчита трафик.

Тунелите използват същата терминология

Тунел през proxy port също завършва с един от тези резултати, така че един набор от етикети покрива и двата продукта. Само пет от седемте могат да възникнат, тъй като двата резултата target изискват FourA да е видял отговора на целта, а отговорът на тунела е вашият собствен криптиран трафик.

Outcome On a tunnel, this means
success Тунелът се отвори и вашият инструмент го получи.
client_error FourA няма да отвори този тунел: частен или резервиран адрес, или порт, който не обслужва.
rate_limit Достигнат е някой от лимитите на вашия план (едновременно отворени тунели, отваряния на тунели в минута, стандартен трафик за периода, премиум трафик, с какъвто не разполагате) или самият порт е достигнал капацитета си или скоростта на отваряне.
service_error FourA нямаше наличен изход за вашата заявка. Обикновено е временно.
service_fail Целта не можа да бъде достигната през нито един изход, който FourA опита: DNS, изтичане на времето за изчакване, отказана връзка.
application_error Никога не възниква при тунел.
application_fail Никога не възниква при тунел.

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

Причина на екрана Какво е изчерпано
port not in plan Вашият план не включва този proxy порт
tunnels at once Всички тунели, позволени едновременно от вашия план, бяха заети
openings per minute Лимитът на отваряния на тунели за тази минута по вашия план беше изчерпан
traffic used up Трафикът по вашия план за този период е изчерпан
premium not available Premium трафикът не е наличен за вашия план в момента
port was full Самият порт беше с изчерпан капацитет или честота на отваряне. Опитайте отново след малко.
port not served FourA не отваря тунели към този порт
private address Частни и запазени адреси не могат да бъдат достъпвани

Нищо свързано с тунел не се таксува в кредити, тъй като тунелът няма request, към който да се начисли такъв. Вместо това портът отчита байтове. Вижте Как се отчита вашият план.

Разчитане на резултатите в таблото за управление

Всеки request, направен от вашия API key, се показва в потока Activity с етикет за неговия резултат. Страниците Metrics и Overview обобщават същото поле за кръгови диаграми и времеви линии.

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

Евристика за повторни опити

Базова политика за повторни опити според резултатите:

Резултат Безопасен повторен опит? Кога
success n/a Имате response.
application_error Понякога Прочетете тялото на грешката от целевия сайт. Някои са временни, повечето не са. Ако X-FourA-Check-Page е зададен, сайтът е сервирал страница за проверка: изпратете URL адреса към Auto, който третира страницата за проверка като стъпка за преминаване, а не като краен отговор.
application_fail Понякога Ако целевият сайт ви налага rate limit, намалете темпото. Ако ви блокира, превключете към endpoint Proxy или Browser.
client_error Не Заявката ще се провали отново по същия начин. Поправете входните данни.
rate_limit Зависи Спазвайте времето за изчакване, върнато в response: Retry-After, retry_after_seconds или retryAfter. При plan_limit_browser_daily спрете до полунощ UTC; при plan_limit_credits или plan_limit_bandwidth спрете до resets_at; при plan_limit_feature или plan_limit_premium променете заявката.
service_error Да Кратко експоненциално отлагане.
service_fail Да Също като service_error.
Обновено: 11 ноември 2026 г.