# Lecture Web

Lire une URL en Markdown, texte, HTML ou capture d'écran.

Lisez une page web spécifique dans un format que votre application peut consommer.

Tous les exemples utilisent `FELO_API_KEY` depuis l'[aperçu](https://openapi.felo.ai/fr/docs/data-api/guides/felo-overview.md). Les appels utilisent **le solde de plateforme**, et non les crédits Felo Pro. Les exemples de réponse sont illustratifs ; le contenu réel et les champs facultatifs varient.

## Point de terminaison

`POST /api/v1/data/web/read`

## Requête

| Champ | Type | Requis | Signification |
|---|---|---|---|
| `url` | string | Oui | URL de page HTTP ou HTTPS |
| `formats` | tableau de strings | Non | Exactement un de `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT` ; Markdown par défaut |
| `mode` | string | Non | `quality` (par défaut), `fast` ou `auto` |
| `timeout` | integer | Non | Délai d'attente en millisecondes, 1–60 000 ; 30 000 par défaut |
| `totalTimeout` | integer | Non | Délai d'attente total en millisecondes, 1–60 000 ; défaut à `timeout` |

Choisissez un seul format de sortie par requête ; n'envoyez pas les quatre dans le même tableau.

```bash
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}'
```

## Réponse

HTTP 200 renvoie le champ de contenu sélectionné à la racine JSON. Une réponse Markdown peut ressembler à ceci :

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

Lisez `markdown`, `text`, `html` ou `screenshot` selon le format demandé. Les autres métadonnées sont facultatives ; n'exigez pas que tous les champs de format soient présents. Consultez le schéma `WebReadResponse` dans la [définition OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) pour la réponse complète.

## Facturation et échecs

`web.read` est facturé par requête. Un délai d'attente n'est pas une page vide : vérifiez le statut HTTP avant d'utiliser le corps. Ne passez pas à des requêtes rapides répétées après un délai d'attente ; suivez [Facturation et erreurs](https://openapi.felo.ai/fr/docs/data-api/guides/felo-billing.md).