Lettura Web
Provider: Felo · Pagato con il saldo della piattaforma
Leggi una pagina web specifica in un formato che la tua applicazione può consumare.
Tutti gli esempi usano FELO_API_KEY dalla panoramica. Le chiamate usano il saldo della piattaforma, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.
Endpoint
POST /api/v1/data/web/read
Richiesta
| Campo | Tipo | Obbligatorio | Significato |
|---|---|---|---|
url | string | Sì | URL della pagina HTTP o HTTPS |
formats | array di stringhe | No | Esattamente uno tra MARKDOWN, TEXT, HTML, SCREENSHOT; predefinito Markdown |
mode | string | No | quality (predefinito), fast o auto |
timeout | integer | No | Timeout in millisecondi, 1–60.000; predefinito 30.000 |
totalTimeout | integer | No | Timeout totale in millisecondi, 1–60.000; predefinito timeout |
Scegli un solo formato di output per richiesta; non inviare tutti e quattro nello stesso array.
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}'Risposta
HTTP 200 restituisce il campo di contenuto selezionato alla radice JSON. Una risposta Markdown può essere simile a questa:
{
"title": "Example Domain",
"markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
"metadata": {}
}Leggi markdown, text, html o screenshot in base al formato richiesto. Altri metadati sono opzionali; non richiedere che ogni campo di formato sia presente. Consulta lo schema WebReadResponse nella definizione OpenAPI per la risposta completa.
Fatturazione ed errori
web.read è fatturato per richiesta. Un timeout non è una pagina vuota: controlla lo stato HTTP prima di usare il body. Non passare a richieste rapide ripetute dopo un timeout; segui Fatturazione ed errori.