# FlashData CLI ile otomasyon

Bir istek için geçerlidir, bir senaryodan çalıştırın ve ayrı bir sonuç ve hata makbuzlarını okuyun.

Canonical referans: https://flashdata.dev/tr/docs/guides/cli-automation
İnceleme: 2026-11-04 Tarafından FlashData

<a id="profiles"></a>

## 1. Mevcut profili seçin

CLI, Bash ve jq'u kullanın. Windows, Git Bash'daki kabuk örneklerini çalıştırın. Bu yürüyüş, özgün bir araştırma profili kullanır; FLASHDATA_STATE_DIR'u bu profilin saklandığı mutlak diziye ayarlayın.

Aynı OS kullanıcısını ve eyalet dizilerini her komutta kullanın. FLASHDATA_API_KEY, kurtarılan anahtarı abartır; profili kullanmaya başlamaz. CLI, .env dosyaları yüklemez.

### Check save access access

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile research --state-dir "$FLASHDATA_STATE_DIR" --json
```

- [CLI'u ilk olarak bağlayın](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#existing-key)

<a id="profile-paths"></a>

### Varsayılan devlet yerleri lokasyonları

Orijinal --state-dir'larınızı özel bir yer seçtiyseniz kullanın. auth status'u rapor etmeli data.accessVerified: true. Önleyici bir dağıtım için, sahibinin anahtarını stdin aracılığıyla gizli mağazasından ithal edin.

| OS | Directory |
| --- | --- |
| Windows | %APPDATA%/FlashData |
| macOS | ~/Library/Application Support/FlashData |
| Linux | $XDG_STATE_HOME/flashdata veya ~/.local/state/flashdata |

- [Geçici sunucu kimlikleri](https://flashdata.dev/tr/docs/guides/production-deployment/reference.md#secrets)

<a id="check"></a>

## 2. İstek ve fiyat doğrulama

request.json'u kurtarın, o zaman aynı dizide ücretsiz çekleri çalıştırın. Filtre baskıları true sadece bir kaynak fiyatı mevcut olduğunda ve denge bir sorguyu kapsar. Bir nonzero çıkışına durdurun. Bir fiyat kontrolü kredi rezervu etmez.

### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
```

### Bash + jq · Hiçbir ödeme teklifi

```bash
set -euo pipefail
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata account balance --profile research --state-dir "$FLASHDATA_STATE_DIR" \
  --json --non-interactive > balance.json
flashdata query --input request.json --dry-run --run-id cli-research-001 \
  --profile research --state-dir "$FLASHDATA_STATE_DIR" \
  --json --non-interactive > preflight.json
jq -e --slurpfile balance balance.json '
  .ok and .data.dryRun and .data.estimateAvailable
  and ($balance[0].ok == true)
  and any(.data.estimate.prices[]?;
    .source == "google_search" and .available == true
    and (.estimatedCredits | type == "number")
    and ($balance[0].data.availableCredits | type == "number")
    and .estimatedCredits <= $balance[0].data.availableCredits)
' preflight.json
```


<a id="json"></a>

## 3. Run ve makbuz oku

Kontroller geçtikten sonra run-search.sh'u kurtarın ve bash run-search.sh çalıştırın. İlk başarılı infaz tek bir arama sunar. Her girişim, dosyaları yeni bir cli-run rehberinde kurtarır; stabil run ID, CLI'nun aynı hesap, profil ve eyalet rehberi için daha erken bir başarı kaydetmesine izin verir.

### run-search.sh

```bash
#!/usr/bin/env bash
set -euo pipefail
umask 077
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
dir=$(mktemp -d "cli-run.XXXXXX")
if ! flashdata query --input request.json --run-id cli-research-001 \
  --profile research --state-dir "$FLASHDATA_STATE_DIR" \
  --output "$dir/result.json" --timeout 2m --json --non-interactive \
  > "$dir/receipt.json" 2> "$dir/error.json"; then
  cat "$dir/error.json" >&2
  printf 'Inspect saved run cli-research-001; receipts: %s\n' "$dir" >&2
  exit 1
fi
jq -e '.schemaVersion == 1 and .ok == true' "$dir/receipt.json" >/dev/null
jq -e '.status == "done" and .source == "google_search"' "$dir/result.json" >/dev/null
jq -r '.results[]?.organic[]? | [.title, .link] | @tsv' "$dir/result.json"
jq '{runId, cached, usage}' "$dir/receipt.json"
printf 'Files: %s\n' "$dir"
```


<a id="receipt-fields"></a>

### Hangi dosyayı okumak için hangi dosyayı bilmek

CLI zarfı ve kaynak cevabı farklı JSON belgeleridir. --output olmadan, kaynak cevabı veridedir. Bu örnek --output'u kullanır, bu nedenle kaydedilen result.json'dan kaynak alanları okuyun.

| Dosya | Read Oku |
| --- | --- |
| receipt.json | Tamam, runId, önbellek, kullanım ve çıkış yolu. Önbellekli bir makbuz orijinal kullanımı rapor eder, yeni bir ücret değil. |
| result.json | source, status, results ve usage alanları. Google Search için results[].organic[] alanını okuyun. Boş bir dizi de geçerli bir arama sonucu olabilir. |
| error.json | Nonzero çıkışında, error.code, error.httpStatus, error.retryAfter ve herhangi bir run/job IDs. |

#### receipt.json · açıklayıcı bir alıntı

```json
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "cli-research-001",
  "cached": false,
  "data": {
    "output": "cli-run.EXAMPLE/result.json"
  },
  "usage": {
    "credits": 0.02
  }
}
```


<a id="recover"></a>

## Başka bir arama olmadan yeniden keşfedin

Yeniden denemeden önce kurtarma işlemine dikkat edin.Inspect the save run before retrying. Orijinal hesaba erişimle, henüz mevcut olmayan bir dosya adı için başarılı bir koşu ihracat. Dava hesabından sahibine kadar geçiş yapar; daha önce ihraç edilen deneme sonuçları tutar ve yeni IDs'u yeni sahibi görevler için kullanın. Aynı koşu ID’nun altında bir değişiklik isteği reddedilir; yeni bir ID kullanmak sadece niyetli yeni bir görev için.

### Inspect, sonra kurtarılmış bir başarı ihracat

```bash
flashdata runs show cli-research-001 --profile research \
  --state-dir "$FLASHDATA_STATE_DIR" --json
flashdata runs show cli-research-001 --result --output recovered.json \
  --profile research --state-dir "$FLASHDATA_STATE_DIR" --json
```

- [Kabul edilen işler, hatalar ve belirsiz gönderimler](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md)

<a id="recurring"></a>

## Senaryonun çalıştığı zaman zamanlama ekle

--recurring'u yerleşik sahibi erişimle kullanın, planlanan olaylar ve kalıcı durum için bir stabil ID kullanın. Bir deneme tekrarlanan işi çalıştıramaz. Ev sahibinizin programı vardır; bayrak sadece erişim kontrol eder. Planlanan güncel kullanım ve yeniden başlatma için tam tekrarlanan koşucuyu kullanın.

- [Tekrarlanan ajan görevleri](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
- [Bir sunucuya veya konteynere işlayın](https://flashdata.dev/tr/docs/guides/production-deployment/reference.md)

<a id="storage"></a>

## Seçmeli: özel indirme depolama depolama depolama

youtube indir --storage-config storage.json, storage.json olarak sadece bu depolama nesnesini kurtarın ve yerel olarak yer sahipleri yerini değiştir. Dosya özel olmalı ve yürütme kullanıcısına ait olmalıdır. Bir indirme yapmadan önce eşleşen izni komutunu kullanın.

### storage.json · S3

```json
{
  "storage_type": "s3",
  "storage_url": "YOUR_BUCKET",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1"
}
```

### Linux / macOS

#### Restrict file access

```bash
chmod 600 storage.json
```


### Windows PowerShell

#### Restrict file access

```powershell
$storagePath = (Resolve-Path -LiteralPath './storage.json').Path
$storageUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().User
$storageAcl = [System.Security.AccessControl.FileSecurity]::new()
$storageAcl.SetOwner($storageUser)
$storageAcl.SetAccessRuleProtection($true, $false)
$storageAcl.AddAccessRule([System.Security.AccessControl.FileSystemAccessRule]::new($storageUser, 'FullControl', 'Allow'))
Set-Acl -LiteralPath $storagePath -AclObject $storageAcl
```


- [Depolama sağlayıcıları ve teslimat sonuçları](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md#storage)
- [Download command](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#commands)

<a id="next"></a>

## İlgili rehberler

- [CLI hızlı bir başlangıç](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md)
- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)
- [Credential storage and revo](https://flashdata.dev/tr/docs/guides/production-deployment/reference.md#maintain)
