# อ่านเว็บ

อ่าน URL เป็น Markdown ข้อความ HTML หรือภาพหน้าจอ.

อ่านเว็บเพจที่ระบุในรูปแบบที่แอปพลิเคชันของคุณสามารถใช้งานได้

ตัวอย่างทั้งหมดใช้ `FELO_API_KEY` จาก [ภาพรวม](https://openapi.felo.ai/th/docs/data-api/guides/felo-overview.md) การเรียกใช้ใช้ **ยอดคงเหลือบนแพลตฟอร์ม** ไม่ใช่ Felo Pro credits ตัวอย่างการตอบกลับมีไว้เพื่อประกอบการอธิบาย; เนื้อหาจริงและฟิลด์เสริมอาจแตกต่างกัน

## เอนด์พอยต์

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

## คำขอ

| ฟิลด์ | ประเภท | จำเป็น | ความหมาย |
|---|---|---|---|
| `url` | string | ใช่ | URL ของหน้า HTTP หรือ HTTPS |
| `formats` | string array | ไม่ | มีได้เพียงหนึ่งใน `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; ค่าเริ่มต้นเป็น Markdown |
| `mode` | string | ไม่ | `quality` (ค่าเริ่มต้น), `fast` หรือ `auto` |
| `timeout` | integer | ไม่ | ระยะหมดเวลาเป็นมิลลิวินาที, 1–60,000; ค่าเริ่มต้น 30,000 |
| `totalTimeout` | integer | ไม่ | ระยะหมดเวลารวมเป็นมิลลิวินาที, 1–60,000; ค่าเริ่มต้นเป็น `timeout` |

เลือกรูปแบบผลลัพธ์หนึ่งแบบต่อคำขอ; อย่าส่งทั้งสี่แบบในอาร์เรย์เดียวกัน

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

## การตอบกลับ

HTTP 200 ส่งคืนฟิลด์เนื้อหาที่เลือกไว้ที่ราก JSON การตอบกลับ Markdown อาจมีลักษณะดังนี้:

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

อ่าน `markdown`, `text`, `html` หรือ `screenshot` ตามรูปแบบที่คุณร้องขอ ข้อมูลเมตาอื่นเป็นตัวเลือก; อย่าบังคับให้ทุกฟิลด์รูปแบบต้องมีอยู่ ดู schema `WebReadResponse` ใน [OpenAPI definition](https://openapi.felo.ai/api/v1/data/openapi.json) สำหรับการตอบกลับฉบับสมบูรณ์

## การเรียกเก็บเงินและความล้มเหลว

`web.read` คิดค่าบริการต่อคำขอ เวลาเกินกำหนดไม่ใช่หน้าเปล่า: ตรวจสอบ HTTP status ก่อนใช้เนื้อหา body อย่าสลับไปใช้คำขอถี่ๆ ซ้ำหลังเกิด timeout; ให้ปฏิบัติตาม [Billing and Errors](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md)