Felo API PlatformFelo API Platform

Felo Odczyt stron internetowych

Dostawca: Felo · Płatność z salda platformy

Odczytaj konkretną stronę internetową w formacie, który może być użyty przez twoją aplikację.

Wszystkie przykłady używają FELO_API_KEY z przeglądu. Wywołania korzystają z salda platformy, a nie z kredytów Felo Pro. Przykłady odpowiedzi mają charakter poglądowy; rzeczywista treść i opcjonalne pola mogą się różnić.

Punkt końcowy

POST /api/v1/data/web/read

Żądanie

PoleTypWymaganeZnaczenie
urlstringTakAdres URL strony HTTP lub HTTPS
formatstablica stringówNieDokładnie jedno z: MARKDOWN, TEXT, HTML, SCREENSHOT; domyślnie Markdown
modestringNiequality (domyślnie), fast lub auto
timeoutintegerNieLimit czasu w milisekundach, 1–60 000; domyślnie 30 000
totalTimeoutintegerNieCałkowity limit czasu w milisekundach, 1–60 000; domyślnie timeout

Wybierz jeden format wyjściowy na żądanie; nie wysyłaj wszystkich czterech w tej samej tablicy.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/read" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","formats":["MARKDOWN"],"mode":"quality","timeout":30000}'

Odpowiedź

HTTP 200 zwraca wybrane pole treści w korzeniu JSON. Odpowiedź Markdown może wyglądać tak:

{
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "metadata": {}
}

Odczytaj markdown, text, html lub screenshot zgodnie z wybranym formatem. Inne metadane są opcjonalne; nie wymagaj obecności każdego pola formatu. Zobacz schemat WebReadResponse w definicji OpenAPI, aby poznać pełną odpowiedź.

Rozliczenia i błędy

web.read jest rozliczany za żądanie. Limit czasu nie oznacza pustej strony: sprawdź status HTTP przed użyciem treści odpowiedzi. Nie przechodź na wielokrotne, szybkie żądania po przekroczeniu limitu czasu; postępuj zgodnie z Rozliczeniami i błędami.

Potrzebujesz pomocy?