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

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

Само success струва кредити. Premium трафикът се отчита отделно от кредитите и не зависи от резултата: вижте Billing Implications.

The Seven Outcomes

Това са седемте възможни изхода за една заявка. Един тунел използва пет от тях: вижте Tunnels Use the Same Vocabulary по-долу.

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

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

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

Success Is validate-Aware

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

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

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

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

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

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

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

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

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

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

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

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

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

Всяка заявка, направена от вашия API ключ, се показва в потока Активност с нейния етикет за резултат. Страниците Метрики и Преглед обобщават същото поле за кръгови диаграми и времеви линии.

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

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

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

Свързани

• API Errors: Грешки в отговорите на HTTP ниво
• Proxy Port: Кодовете за статус, с които се връща отказът на тунела
• Rate Limits: Какво задейства rate_limit и двата формата, под които се връща
• Metrics: Къде да намерите разбивка на резултатите
• Activity Log: История на резултатите за всяка заявка