# Realtime ve async

Yanıtda sonuçları alın veya bir iş gönderin ve daha sonra alın. Uygulamanızın veya acentenizin iş için nasıl bekleyeceğini seçin.

Canonical referans: https://flashdata.dev/tr/docs/reference/realtime-and-async
İnceleme: 2026-11-04 Tarafından FlashData

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

## Bir istek modu seçin

Google Search ve YouTube Data iki modu da destekler. YouTube Download için async, Batch veya Bulk gerekir; realtime desteklenmez. Realtime modundan async moduna geçerken kaynak parametreleri aynı kalır.

| Mode Mode | Ne zaman kullanın | Ne aldığınızı |
| --- | --- | --- |
| Realtime | Mevcut etkileşimde bir arama sonucu gereklidir. | Sonuç vücut aynı HTTP cevabı. |
| Async | Çalışma, işlem bağlantılarından sonra devam etmeli veya medyayı indiriyorsunuz. | Bir iş ID hemen; statü getir ve ayrı sonuçlar. |

### Yaşam döngüsü

```text
Realtime  POST data.flashdata.dev/v1/queries/realtime → Sonuçlar
Async POST data.flashdata.dev/v1/queries → iş ID
          GET  api.flashdata.dev/v2/jobs/{id}         → statü
          GET  api.flashdata.dev/v2/jobs/{id}/results → Sonuçlar
```

- [Birçok sorguyu gönderin mi?](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md)

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

## Bir istek gönder

Set Set Set FLASHDATA_API_KEY Bir anahtara izin veren google_search. Gerçek zamanlı veya async seçin; her bir teslim bir faturalı arama yapar. Senaryoları, makbuzları ve sonuçları aynı yeni çalışma klasöründe tut.

Python örnekleri Python 3.10 + ve İstekleri kullanır. Her senaryo bağımsız olarak çalışır ve dosyaları daha önceki adımlardan okur. cURL alternatifi Bash, cURL 7.76 + ve jq'ye ihtiyaç duyar.

### Python · bir kez yüklemek

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

- [API anahtar ve başlıkları](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)
- [Google Search parametreleri](https://flashdata.dev/tr/docs/sources/google_search/reference.md)

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

### Realtime: Şimdi sonucu elde edin

POST /v1/queries/realtime, status: done ve bir sonuç dizisi döndürür. result.json'u okuyun; ankete gerek yok.

#### Python

realtime.py olarak tasarruf edin ve python3 realtime.py çalıştırın.

##### 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

##### Sonuç alın · 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: Bir iş makbulunu kurtarmak

POST /v1/queries, arama sonuçları değil, bekleyen bir iş makbulunu döndürür. submission.json'u kurtarın ve aşağıdaki isteklere devam edin.

#### Python

submit_async.py olarak tasarruf edin ve python3 submit_async.py çalıştırın.

##### 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))
```

##### Receipt alanları · kısaltılmış örnek

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

##### Receipt alanları · kısaltılmış örnek

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



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

## Bir async işi kontrol edin

job.status ile ID'u submission.json'da kullanarak okuyun. Beklemek veya işlemek için, tekrar kontrol etmeden önce Retry-After gecikmesini bekleyin; Python yazdırır ve cURL bunu status-headers.txt'da kurtarır. Hiçbir ipucu iade edilmezse geri dönün. Başarılı bir durum isteği, işin tamamlanmadığı anlamına gelmez.

| job.status | Sonraki eylem |
| --- | --- |
| pending / processing | Bekle, sonra aynı işi ID'u tekrar kontrol edin. |
| completed | Kurtarılan sonucu izleyin. |
| failed | job.error'u okuyun. Yeni çalışmayı sunmadan önce nedeni düzeltin. |

### Python

job_status.py olarak tasarruf edin ve python3 job_status.py çalıştırın.

#### 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

#### statüsünü okuyun · 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>

## Erişim tarihi: The completed result

Bunu job.status tamamlandıktan sonra çalıştırın. Varsayılan sonuçlar cevabı 302: İmzalanmış bir depolamaya işaret ediyor URL. Aşağıdaki iki istek, API anahtarını FlashData'da tutar ve orijinal JSON'yu result.json'ya kurtar. YouTube Download için, bu JSON, depolamanıza teslim edilen medyayı anlatıyor; video veya ses dosyası değil.

### Python

job_result.py olarak tasarruf edin ve python3 job_result.py çalıştırın.

#### 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

#### Fetch orijinal 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, metin ve Markdown formatları](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#completed-results)
- [İndir depolama kurulumu](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)

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

## gecikmeler ve başarısızlıklar

| Durum durumu | Yapılacak işlem |
| --- | --- |
| Submission timed out | Bir POST zaten kabul edilebilir. Kurtarılmış makbuz ve hesap tarihini yeniden göndermeden önce kontrol edin; Tekrarlanan POST'ler yeni faturalı işler yaratabilir. |
| 409 · result_not_ready | Kirliliği tutun. Başka bir iş yaratmaz. |
| 422 · result_not_ready | İş başarısız oldu. job.error'u yeniden denemeden önce okuyun. |
| 429 | Honor Retry-After veya retry_after; bekleme kapasitesi dolduğunda teslim oranı azaltır. |
| 410 · result_expired | Mağazalı sonuçlar tamamlandıktan sonra 24 saatlerini sona erdirir. Kurtarılan kopyasını kullanın. |

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md)
- [CLI, anket ve webhook yürüyüş](https://flashdata.dev/tr/docs/guides/async-batch/reference.md)
