# ওয়েব রিড

একটি URL-কে Markdown, text, HTML বা screenshot হিসেবে পড়ুন।

একটি নির্দিষ্ট web page এমন একটি format-এ পড়ুন, যা আপনার application গ্রহণ করতে পারে।

সব example-ই [overview](https://openapi.felo.ai/bn/docs/data-api/guides/felo-overview.md) থেকে `FELO_API_KEY` ব্যবহার করে। Call-গুলো **platform balance** ব্যবহার করে, Felo Pro credits নয়। Response example-গুলো illustrative; live content এবং optional field ভিন্ন হতে পারে।

## এন্ডপয়েন্ট

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

## অনুরোধ

| ক্ষেত্র | ধরন | প্রয়োজনীয় | অর্থ |
| --- | --- | --- | --- |
| `url` | string | হ্যাঁ | HTTP অথবা HTTPS পৃষ্ঠা URL |
| `formats` | স্ট্রিং অ্যারে | না | `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`-এর মধ্যে ঠিক একটি; ডিফল্ট Markdown |
| `mode` | string | না | `quality` (ডিফল্ট), `fast` অথবা `auto` |
| `timeout` | integer | না | মিলিসেকেন্ডে সময়সীমা, 1–60,000; ডিফল্ট 30,000 |
| `totalTimeout` | integer | না | মিলিসেকেন্ডে মোট সময়সীমা, 1–60,000; ডিফল্ট `timeout` |

প্রতি request-এ একটি output format বেছে নিন; একই array-এ চারটিই পাঠাবেন না।

```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 root-এ নির্বাচিত content field ফেরত দেয়। একটি Markdown response এমন হতে পারে:

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

আপনি যে format চেয়েছিলেন, সে অনুযায়ী `markdown`, `text`, `html` বা `screenshot` পড়ুন। অন্যান্য metadata optional; প্রত্যেক format field উপস্থিত থাকবে—এমনটি আবশ্যক করবেন না। সম্পূর্ণ response-এর জন্য [OpenAPI definition](https://openapi.felo.ai/api/v1/data/openapi.json)-এ `WebReadResponse` schema দেখুন।

## বিলিং এবং ব্যর্থতা

`web.read` প্রতি request-এ বিল হয়। Timeout মানে ফাঁকা page নয়: body ব্যবহার করার আগে HTTP status পরীক্ষা করুন। Timeout-এর পরে বারবার দ্রুত request-এ স্যুইচ করবেন না; [Billing and Errors](https://openapi.felo.ai/bn/docs/data-api/guides/felo-billing.md) অনুসরণ করুন।