Đọc Web
Nhà cung cấp: Felo · Thanh toán bằng số dư nền tảng
Đọ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. 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.
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:
{
"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 để 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.