Резултати от заявки
Всяка заявка към 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. |
Свързани
- Грешки в API: Грешки в response на ниво HTTP
- Порт за proxy: Кодовете за състояние, под които идва отказът на тунела
- Rate limit-и: Какво задейства
rate_limitи двете му форми на връщане - Метрики: Къде да видите разбивка на резултатите
- Дневник на активността: История на резултатите за всяка request