# Đọc Web Felo

POST /api/v1/data/web/read

Đọc một trang web cụ thể ở định dạng mà ứng dụng của bạn có thể sử dụng.

Tất cả ví dụ dùng `FELO_API_KEY` từ [tổng quan](https://openapi.felo.ai/vi/docs/data-api/guides/felo-overview.md). Các cuộc gọi sử dụng **số dư nền tảng**, không phải tín dụng Felo Pro. Các ví dụ phản hồi chỉ mang tính minh họa; nội dung thực tế và các trường tùy chọn sẽ thay đổi.

## Endpoint

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

## Yêu cầu

| Trường | Kiểu | Bắt buộc | Ý nghĩa |
|---|---|---|---|
| `url` | string | Có | URL trang HTTP hoặc HTTPS |
| `formats` | mảng chuỗi | Không | Chính xác một trong `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; mặc định là Markdown |
| `mode` | string | Không | `quality` (mặc định), `fast` hoặc `auto` |
| `timeout` | integer | Không | Thời gian chờ tính bằng mili giây, 1–60.000; mặc định 30.000 |
| `totalTimeout` | integer | Không | Tổng thời gian chờ tính bằng mili giây, 1–60.000; mặc định là `timeout` |

Chọn một định dạng đầu ra cho mỗi yêu cầu; không gửi cả bốn trong cùng một mảng.

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

## Phản hồi

HTTP 200 trả về trường nội dung được chọn ở gốc JSON. Một phản hồi Markdown có thể trông như sau:

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

Đọc `markdown`, `text`, `html` hoặc `screenshot` theo định dạng bạn đã yêu cầu. Các siêu dữ liệu khác là tùy chọn; đừng yêu cầu mọi trường định dạng phải luôn có. Xem lược đồ `WebReadResponse` trong [định nghĩa OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) để biết phản hồi đầy đủ.

## Thanh toán và lỗi

`web.read` được tính phí theo từng yêu cầu. Hết thời gian chờ không có nghĩa là trang rỗng: hãy kiểm tra trạng thái HTTP trước khi dùng nội dung phản hồi. Đừng chuyển sang các yêu cầu lặp lại liên tục sau khi timeout; hãy tuân theo [Thanh toán và Lỗi](https://openapi.felo.ai/vi/docs/data-api/guides/felo-billing.md).