Създаване на задача
Това ръководство ви превежда през създаването на API ключ и изпращането на първата ви заявка чрез FourA Dashboard.
Стъпка 1: Отворете Dashboard
Отидете в Dashboard и влезте с вашия FourA акаунт.
Стъпка 2: Създайте API ключ
Отидете на страницата API Keys и щракнете върху Create API key. След като вече имате ключ, бутонът над списъка става Create Key.
Дайте на ключа описателно име (напр. "production-scraper" или "dev-testing"). Диалоговият прозорец API Key Created показва ключа в чист текст с бутон за копиране, а под Test your first request се намира готова за изпълнение curl команда с Copy command. На телефон или таблет, Try it in the Playground ви отвежда директно там.
Ако пропуснете момента, по-късно щракнете върху иконата с око на реда на ключа, за да го видите отново. Стари ключове, създадени преди добавянето на показването, не могат да бъдат възстановени; прегенерирайте ги веднъж, за да преминете напред. Пълен процес: Управление на API ключове.
Вашият ключ изглежда така: pk_live_a1b2c3d4e5f6...
Стъпка 3: Изберете endpoint
FourA предлага четири endpoint-а за различни сценарии:
Auto (POST /api/auto/)
Интелигентният избор по подразбиране. Подайте URL, в идеалния случай с правило validate, и FourA преминава по стъпки от ротиращо proxy до пълен браузър през proxy, спирайки на първия отговор, който е успешен. Задайте forceProxy: false, за да опита първо с директна заявка. Най-добрият избор, когато обработвате нов сайт и все още не знаете от какво се нуждае.
Single (POST /api/single/)
Изпраща бърза HTTP заявка. Най-подходящ за статични HTML страници и API endpoints. Време за отговор: обикновено под 2 секунди.
Browser (POST /api/browser/)
Стартира инстанция на Chrome браузър за рендиране на JavaScript. Най-подходящ за SPA, съдържание с lazy loading и страници, изискващи изпълнение на JS. Време за отговор: от 2 до 10 секунди.
Proxy (POST /api/proxy/)
Маршрутизира заявката през ротиращи проксита с автоматичен retry. Най-подходящ за сайтове, които проверяват източника на заявката, или връщат различно съдържание според държавата.
Стъпка 4: Изпратете първата си заявка
Отворете терминал и изпълнете:
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://example.com"}'
Стъпка 5: Прочетете отговора
{
"status": 200,
"headers": [
{
"result": { "version": "HTTP/2", "code": 200, "reason": "" },
"content-type": "text/html; charset=UTF-8",
"content-length": "1256"
}
],
"data": "<html>...</html>",
"total_time": 0.45
}
Полето headers е масив от обекти, по един за всяка стъпка на пренасочване. Всеки запис има result със статус реда плюс всеки response header, върнат от целевия сайт.
Ключови полета:
- status: HTTP статус код от целевия сайт
- data: тялото на response (HTML, JSON или суров текст)
- total_time: продължителност на request в секунди
Стъпка 6: Опитайте browser request
Ако целевата страница използва JavaScript за рендиране на съдържание, използвайте browser endpoint вместо това:
curl -X POST https://eu.api.foura.ai/api/browser/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/products", "timeout_ms": 15000}'
Browser response използва body вместо data:
{
"status": 200,
"headers": {"content-type": "text/html"},
"body": "<html>...</html>"
}
Често срещани проблеми
| Проблем | Решение |
|---|---|
| Не сте сигурни кой engine да използвате | Започнете с auto endpoint. Той избира правилния път и запомня какво е проработило. |
| Празно съдържание | Преминете от single към browser endpoint: страницата вероятно изисква JS рендериране |
| Страница за потвърждение в отговора | Преминете към proxy endpoint за автоматична ротация на IP |
| Timeout | Увеличете timeout_ms или проверете дали URL адресът е правилен |
| Изгубен ключ | Кликнете върху иконата с око на реда на ключа в API Keys, за да го покажете, или го генерирайте отново, ако е от стар тип |
Следващи стъпки
- Преглед на таблото: Пълно ръководство за таблото за управление
- Playground: Тествайте заявки в таблото, преди да пишете код
- Smart Fetch (Auto): Подробен преглед на auto endpoint
- Избор на правилния endpoint: Подробно сравнение
- Често срещани проблеми: Бързо решаване на проблеми