# Realtime และ async

รับผลลัพธ์ในคำตอบทันที หรือส่งงานแล้วรับผลภายหลัง เลือกวิธีรอผลที่เหมาะกับแอปหรือเอเจนต์

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/reference/realtime-and-async
Recorder: 2026-11-04 โดย FlashData

<a id="choose"></a>

## เลือกโหมดร้องขอ

Google Search ถึง YouTube Data รองรับทั้งสองโหมด YouTube Download ต้องการเอซิงค์ Batch หรือ Bulk.; ไม่ สนับสนุน เวลา จริง ๆ. ตัวแปรแหล่งยังคงเดิมเมื่อเปลี่ยนจากเวลาจริงเป็น aync

| โหมด | ใช้เมื่อ | สิ่งใดที่ท่านได้รับ |
| --- | --- | --- |
| Realtime | ต้องการผลลัพธ์การค้นหาในการโต้ตอบในปัจจุบัน | ร่างที่มีผลในการตอบสนอง HTTP แบบเดียวกัน |
| Async | งานควรจะทําต่อไป หลังจากโพรเซสของคุณยุติการทํางาน หรือคุณกําลังดาวน์โหลดสื่ออยู่ | งาน ID ทันที เรียกสถานะและผลแยก |

### ขอรถชูชีพ

```text
Realtime  POST data.flashdata.dev/v1/queries/realtime ○ ผล
Async     POST data.flashdata.dev/v1/queries          ○ งาน ID
          GET  api.flashdata.dev/v2/jobs/{id}         ○ สถานะ
          GET  api.flashdata.dev/v2/jobs/{id}/results ○ ผล
```

- [ยอมแพ้หลายคําถาม?](https://flashdata.dev/th/docs/reference/batch-and-bulk/reference.md)

<a id="submit"></a>

## ส่งคําขอมา

ตั้งค่า FLASHDATA_API_KEY กุญแจที่อนุญาตให้ใช้ google_search. เลือกเวลาจริง หรือ asinc; การส่งแต่ละรายการใช้การค้นหาแบบเดียวที่สามารถเรียกดูได้ เก็บสคริปต์, ใบเสร็จ และผลลัพธ์ไว้ในโฟลเดอร์ที่ทํางานใหม่เดียวกัน

Python ตัวอย่างที่ใช้ Python 3.10+ และร้องขอ แต่ละสคริปต์ทํางานอย่างอิสระ และทําการอ่านแฟ้มจากขั้นตอนก่อนหน้า เดอะ cURL ทางเลือกที่ต้องการ Bash, cURL 7.76+ และ jq.

### Python การติดตั้ง AH หนึ่งครั้ง

```bash
python3 -m pip install requests
```

- [API กุญแจและส่วนหัว](https://flashdata.dev/th/docs/guides/headers-and-authentication/reference.md)
- [Google Search พารามิเตอร์](https://flashdata.dev/th/docs/sources/google_search/reference.md)

<a id="realtime"></a>

### Realtime: รับผลตอนนี้

POST /v1/queries/realtime กลับค่า status: done และผลที่ได้คือ อ่าน result.json; ไม่จําเป็นต้องใช้ผลสํารวจ

#### Python

บันทึกเป็น realtime.py และเรียก python3 realtime.py.

##### realtime.py

```python
import json
import os
from pathlib import Path

import requests

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"source": "google_search", "query": "battery recycling research", "params": {"num": 5}},
    timeout=120, allow_redirects=False,
)
response.raise_for_status()
result = response.json()
Path("result.json").write_text(json.dumps(result, indent=2), encoding="utf-8")
print(json.dumps(result, indent=2))
```


#### cURL / Bash

##### รับผลที่ออกมา cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' \
  --output result.json &&
jq '{source, status, results, usage}' result.json
```



<a id="async"></a>

### Async: บันทึกใบเสร็จค่างาน

POST /v1/queries คืนใบเสร็จค่างานที่ค้างคา ไม่ใช่ผลการค้นหา บันทึก submission.json และทําต่อไปกับสถานะที่ต้องการด้านล่างนี้

#### Python

บันทึกเป็น submit_async.py และเรียก python3 submit_async.py.

##### submit_async.py

```python
import json
import os
from pathlib import Path

import requests

response = requests.post(
    "https://data.flashdata.dev/v1/queries",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json={"source": "google_search", "query": "battery recycling research", "params": {"num": 5}},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
result = response.json()
Path("submission.json").write_text(json.dumps(result, indent=2), encoding="utf-8")
print(json.dumps(result, indent=2))
```

##### ช่องข้อมูล receept example

```json
{
  "id": "job_EXAMPLE",
  "source": "google_search",
  "status": "pending"
}
```


#### cURL / Bash

##### ส่งข้อมูลและรักษางานไว้ ID · cURL / Bash

```bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' \
  --output submission.json &&
jq '{id, source, status, links}' submission.json
```

##### ช่องข้อมูล receept example

```json
{
  "id": "job_EXAMPLE",
  "source": "google_search",
  "status": "pending"
}
```



<a id="status"></a>

## ตรวจสอบงาน Asinc

อ่าน job.status ใช้ ID ใน submission.json. สําหรับระหว่างหรือการประมวลผลรอ Retry-After หน่วงเวลาก่อนที่จะตรวจสอบอีกครั้ง Python ลายนิ้วมือมันและ cURL บันทึกไว้ใน status-headers.txt. ใช้ย้อนกลับหากไม่มีการส่งคําใบ้กลับ การร้องขอสถานะที่ประสบความสําเร็จ ไม่ได้หมายความว่างานนั้นเสร็จสมบูรณ์แล้ว

| job.status | การกระทําถัดไป |
| --- | --- |
| pending / processing | เดี๋ยว เช็คงานเดิมที่ ID อีกครั้ง |
| completed | รับผลที่บันทึกไว้ |
| failed | อ่าน job.error. แก้ไขต้นเหตุก่อนที่จะส่งงานใหม่ |

### Python

บันทึกเป็น job_status.py และเรียก python3 job_status.py.

#### job_status.py

```python
import json
import os
from pathlib import Path

import requests

job_id = json.loads(Path("submission.json").read_text(encoding="utf-8"))["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/jobs/{job_id}",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
Path("job.json").write_text(json.dumps(response.json(), indent=2), encoding="utf-8")
print(json.dumps(response.json()["job"], indent=2))
print("Retry-After:", response.headers.get("Retry-After", "not provided"))
```


### cURL / Bash

#### อ่านสถานะที่อ่านแล้ว cURL / Bash

```bash
JOB_ID=$(jq -er '.id' submission.json)
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/$JOB_ID" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --dump-header status-headers.txt --output job.json &&
jq '.job | {id, source, status, error}' job.json
```



<a id="results"></a>

## รับผลที่เสร็จสมบูรณ์แล้ว

ประมวลผลหลังจาก job.status เสร็จสมบูรณ์แล้ว การตอบสนองปริยายของผลคือ 302ที่อยู่ของที่เก็บของที่ลงนาม URL. สองคําขอที่ด้านล่างเก็บของคุณ API กุญแจบน FlashData และบันทึกต้นฉบับ JSON ถึง result.json. สําหรับ YouTube Downloadนี่... JSON อธิบายถึงสื่อที่จะส่งไปยังจัดเก็บของคุณ; มันไม่ใช่แฟ้มวิดีโอหรือเสียง

### Python

บันทึกเป็น job_result.py และเรียก python3 job_result.py.

#### job_result.py

```python
import json
import os
from pathlib import Path

import requests

receipt = json.loads(Path("submission.json").read_text(encoding="utf-8"))
job_id = receipt["id"]
response = requests.get(
    f"https://api.flashdata.dev/v2/jobs/{job_id}/results",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    timeout=30, allow_redirects=False,
)
response.raise_for_status()
if response.status_code != 302:
    raise RuntimeError(f"Expected a result redirect, got {response.status_code}")
url = response.headers["Location"]
if not url.startswith("https://"):
    raise ValueError("Expected an HTTPS storage URL")

# A separate request: no FlashData key is sent to storage.
result = requests.get(url, timeout=120)
result.raise_for_status()
data = result.json()  # Requests automatically decodes Content-Encoding: gzip.
Path("result.json").write_text(json.dumps(data, indent=2), encoding="utf-8")
print(json.dumps(data, indent=2))
```


### cURL / Bash

#### ดึงข้อมูลต้นฉบับ JSON · cURL / Bash

```bash
JOB_ID=$(jq -er '.id' submission.json)
RESULT_URL=$(curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/$JOB_ID/results" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --output /dev/null --write-out '%{redirect_url}') &&
curl --fail-with-body --silent --show-error --compressed --proto '=https' \
  "${RESULT_URL:?Expected a signed result URL}" --output result.json &&
jq '{source, status, results, usage}' result.json
```


- [JSONข้อความ และ Markdown รูปแบบ](https://flashdata.dev/th/docs/guides/response-formats/reference.md#completed-results)
- [ตั้งค่าคลังเก็บการดาวน์โหลด](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)

<a id="recovery"></a>

## จัดการกับความล่าช้าและความล้มเหลว

| สถานการณ์ | วิธีแก้ไข |
| --- | --- |
| หมดเวลาการรับส่งข้อมูลแล้ว | A POST อาจได้รับการยอมรับแล้วก็ได้ Check ของคุณที่บันทึกไว้และประวัติบัญชีก่อนที่จะทําการแทนที่ POSs ซ้ํา สามารถสร้างงานใหม่ที่สามารถเรียกเก็บเงินได้ |
| 409 · result_not_ready | ให้ผลสํารวจสถานะ. อย่าสร้างงานอื่น |
| 422 · result_not_ready | งานล้มเหลว อ่าน job.error ก่อนทําการลองใหม่ |
| 429 | เกียรติ Retry-After หรือ retry_afterลดอัตราการรับส่งข้อมูลเมื่อความจุเต็ม |
| 410 · result_expired | ผลที่เก็บไว้จะหมดอายุเมื่อ 24 ชั่วโมงหลังจากเสร็จสมบูรณ์แล้ว ใช้สําเนาที่บันทึกไว้ของคุณ |

- [ข้อผิดพลาดและรหัสสถานะ](https://flashdata.dev/th/docs/errors/reference.md)
- [CLI, การสํารวจและเดินเว็บฮุคผ่าน](https://flashdata.dev/th/docs/guides/async-batch/reference.md)
