# FAQ dan pemecahan masalah

Periksa aksesmu, perbaiki permintaan yang gagal atau temukan jawaban tentang penggunaan FlashData.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/troubleshooting
Diulang: 2026-11-04 oleh FlashData

- [Perbaiki galat](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#fix) — Perintah dan perbaikan oleh gejala
- [Pertanyaan umum](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#faq) — Akses, kredit, dan data

<a id="diagnose"></a>

## Mulai dengan pemeriksaan akses bebas

Jalankan pemeriksaan di mana tugas gagal. Gunakan kredensial yang ada; perintah ini tidak mengirimkan sebuah permintaan.

### CLI

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

#### Rekening bebas dibaca

```bash
flashdata --version
flashdata doctor --offline
flashdata auth status --json
```

- [Mengatur suatu kunci](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan. Membutuhkan cURL 7.76 +.

#### Baca akun JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan.

#### Baca akun JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [401 / 403: kredensial](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#credentials)
- [402: kredit](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#credits)
- [429: batas kecepatan](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#rate-limit)
- [400 / 422: permintaan](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#request)
- [Tugas yang tertunda atau gagal](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#jobs)
- [Timeout / 5xx](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#uncertain)
- [Koneksi MCP](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#mcp)

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

### Apa yang harus diperiksa

Identitas harus memiliki access: ready dan termasuk sumber Anda dalam lingkup. Dalam CLI JSON, identitas tersebut berada di data.identity.identity; juga memerlukan data.accessVerified: true. Perintah sukses dengan accessVerified: false belum diverifikasi akses.

Untuk profil CLI bernama, tambahkan --profile NAMA ke setiap perintah di bawah ini. Pertahankan pengguna asli --state-dir dan OS. FLASHDATA_API_KEY overrides yang disimpan CLI kunci; SDK dan MCP host menggunakan konfigurasi kredensial mereka sendiri.


<a id="fix"></a>

## Cari dan perbaiki masalah

Buka gejala yang cocok dengan kesalahanmu. Gunakan IDs dan tanda terima dari tugas asli.


<a id="runtime"></a>

### Perintah tak ditemukan atau profil hilang

Tak ada executable: pasang rilis untuk OS/CPU Anda dan tambahkan direktori ke PATH. Hilang profil: gunakan asli pengguna OS dan direktori state. Periksa di dalam penjadwalan atau kontainer, juga.

#### Bash

##### Temukan executable

```bash
command -v flashdata
flashdata --version
flashdata doctor --offline
```


#### PowerShell

##### Temukan executable

```powershell
Get-Command flashdata
flashdata --version
flashdata doctor --offline
```


- [CLI instalasi](https://flashdata.dev/id/docs/guides/flashdata-cli/reference.md#install)
- [Profil dan direktori keadaan](https://flashdata.dev/id/docs/guides/cli-automation/reference.md#profiles)

<a id="credentials"></a>

### 401 / 403: kunci, scope atau expiry

Untuk mengganti kunci pemilik yang disimpan, tempelkan kunci yang disetujui ke prompt tersembunyi. Jika FLASHDATA_API_KEY diset, perbarui rahasia tersebut dalam waktu-jalan; menyimpan kunci CLI lain tidak akan menimpa itu.

1. 401: periksa untuk kadaluarsa, dicabut atau tidak benar dikonfigurasi kunci. 403: bandingkan sumber yang diminta dengan scope identitas.
2. REST dan SDK menggunakan X-API-Key. An MCP OAuth token tidak dapat menggantikan sebuah API kunci. Untuk akses sementara, gunakan pemulihan klaim di bawah ini.

#### Ganti dan verifikasi kunci pemilik yang disimpan

```bash
flashdata auth login --replace
flashdata auth status --json
```

- [Hak kunci dan rotasi](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Klaim pemulihan](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#claim)
- [MCP reconnect](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#mcp)

<a id="claim"></a>

### Klaim disetujui, tapi agen masih memiliki akses percobaan

Selesai handoff dalam sama CLI profil yang menciptakan klaim. Pemilik melengkapi pendaftaran, verifikasi email dan persetujuan dalam peramban; CLI menerima kredensial tersebut.

#### Sudah disetujui

##### Selesai dan verifikasi

```bash
flashdata auth finish --wait --timeout 10m
flashdata auth status --json
```


#### Taut kadaluarsa

Meminta link baru untuk percobaan yang ada, biarkan pemilik menyetujui, kemudian jalankan auth finish. Jangan jalankan init lagi.

##### Memperbaharui link klaim

```bash
flashdata auth claim
```


- [Klaiming dan handoff](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#help)
- [Periksa akses pemilik untuk tugas yang berulang](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)

<a id="credits"></a>

### 402: kredit tidak mencukupi

Bandingkan availableCredits dengan harga saat ini untuk sumber Anda. Klaim percobaan kelelahan untuk menggunakan keseimbangan pemilik, atau biarkan pemilik ulasan Billing sebelum mencoba kembali.

#### CLI

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

##### Rekening bebas dibaca

```bash
flashdata account balance
flashdata account pricing --source google_search --request-count 1
```

- [Mengatur suatu kunci](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md#store)

#### Bash / cURL

Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan. Membutuhkan cURL 7.76 +.

##### Baca akun JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)
```


#### PowerShell 7

Gunakan tugas yang ada FLASHDATA_API_KEY di terminal yang sama, kontainer atau pekerjaan yang dijadwalkan.

##### Baca akun JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/balance"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
  $flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [Billing](https://flashdata.dev/app/billing)
- [Uji coba dan penautan akun](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md)
- [Harga bagi sumber lain](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md)

<a id="rate-limit"></a>

### 429: tunggu sebelum mencoba kembali

Baca Retry-After pada respon gagal: detik atau tanggal HTTP. Tunggu sampai saat itu dan mengurangi konkurensi. Registrasi pengadilan memungkinkan tiga registrasi per IP per 24-hour window; gunakan kembali profil asli dan bukti pendaftaran.

Pembacaan gratis ini menunjukkan header, status, dan tubuh. Gunakan Retry-After dari operasi yang gagal; query, registrasi dan akuntansi dapat berbeda.

#### Menangkap respon Bash / cURL / jq

```bash
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --dump-header diagnostic-headers.txt --output diagnostic.json \
  --write-out '%{http_code}\n' \
  'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
  $1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
  jq '{access, scopes, status, code, requestId}
    | with_entries(select(.value != null))' diagnostic.json
else
  printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)
```

#### Inspeksi kapasitas akun

```bash
flashdata account limits
```

- [Batas tingkat dan mundur](https://flashdata.dev/id/docs/guides/usage-and-limits/reference.md)

<a id="request"></a>

### 400 / 422: menolak masukan atau pemrosesan gagal

Baca kode, detail dan fieldErrors dari kesalahan HTTP. Benar tubuh permintaan, menyimpannya sebagai request.json, kemudian memvalidasikannya. Simpan kredensial penyimpanan Unduh dalam berkas masukan privat. Jika 422 berasal dari hasil pekerjaan yang ada, periksa job.error terlebih dahulu.

#### Validasi tanpa penyerahan dibayar

```bash
flashdata query --input request.json --mode async --dry-run --json
```

- [Referensi permintaan sumber](https://flashdata.dev/id/docs/reference/reference.md)
- [Masukan unduhan pribadi](https://flashdata.dev/id/docs/guides/cli-automation/reference.md#storage)
- [Inspeksi pekerjaan yang telah ada](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md#jobs)

<a id="jobs"></a>

### Pekerjaan tertunda, atau HTTP 200 dengan pekerjaan gagal

Baca pekerjaan dari submission.json, tanda terima async Anda yang tersimpan. HTTP 200 berarti pembacaan status berhasil; job.status adalah hasil tugasnya (data.status in CLI JSON). Untuk Batch, simpan entri relevan dari query sebagai submission.json.

| Keadaan atau galat | Aksi berikutnya |
| --- | --- |
| pending / processing | Tunggu pada pekerjaan yang sama; jangan mengirimkannya lagi. |
| completed | Ambil dan simpan hasil yang telah ada. |
| failed | Inspeksi job.error sebelum mengirimkan pekerjaan yang dikoreksi. |
| 404 | Periksa pekerjaan ID dan akun pengiriman. |
| 409 | Hasil belum siap. Tetap lakukan polling. |
| 410 | JSON Tersimpan habis setelah jam 24. Gunakan salinan tersimpan Anda; media yang dikirim memiliki penyimpanan sendiri. |

#### CLI

##### Inspeksi tugas yang disimpan Bash / jq

```bash
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)
```

##### Masih berjalan! Gunakan yang kembali JOB_ID

```bash
flashdata jobs wait JOB_ID
```

##### Selesai memakai nama berkas keluaran baru

```bash
flashdata jobs result JOB_ID --output recovered-result.json
```


#### HTTP / cURL

##### Inspeksi tugas yang disimpan

```bash
# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
  | select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Accept: application/json' \
  "$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)
```


- [HTTP polling dan hasil pengambilan](https://flashdata.dev/id/docs/guides/async-batch/reference.md)
- [Kapasitas wajib-pekerjaan](https://flashdata.dev/id/docs/guides/usage-and-limits/reference.md)

<a id="uncertain"></a>

### Timeout / 5xx: apakah tugas diterima?

Periksa asli run dan History sebelum mencoba kembali POST. Menerima kembali pekerjaan yang diterima. Jika penerimaan tidak diketahui, pastikan ID dijalankan dan dukungan kontak; mengubah IDs dan menyerahkan kembali dapat menduplikasi biaya.

#### Inspeksi terlebih dahulu RUN_ID

```bash
flashdata runs show RUN_ID
```

#### Recover dikonfirmasi menerima pekerjaan

```bash
flashdata runs recover RUN_ID
```

- [Meminta riwayat](https://flashdata.dev/app/jobs)
- [Keputusan pemulihan](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)

<a id="output"></a>

### CLI output_exists: berkas hasil sudah ada

Berkas CLI tidak menimpa berkas --output. Baca berkas yang sudah ada, atau pilih nama berkas keluaran baru saat menyimpan permintaan asli --run-id. Jangan ciptakan ID baru untuk melewati kesalahan ini.

#### Inspeksi run asli

```bash
flashdata runs show RUN_ID
```

- [Berkas keluaran dan jalankan pemulihan](https://flashdata.dev/id/docs/guides/cli-automation/reference.md)

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

### Pencarian kosong, takarir keterangan atau download yang tak dapat dibaca

Perintah ini hanya membaca berkas hasil lokal, bukan CLI's stdout amplop.

#### Google Search

Jika status selesai dan organik kosong, filter query longgarkan. Simpan hasil kosong dalam catatan tugas Anda.

##### Inspeksi hasil disimpan Bash / jq

```bash
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.json
```

- [Cari filter dan paginasi](https://flashdata.dev/id/docs/guides/google-search-guide/reference.md)

#### YouTube captions

Metadata daftar kode bahasa, bukan apakah trek manual atau otomatis. Pilih bahasa terdaftar dan atur otomatis explicitly: true untuk otomatis, false untuk manual. Tak ada trek yang cocok berarti tak ada takarir bagi pemilihan itu; FlashData tidak menghasilkan pengganti.

##### Inspeksi bahasa yang tersedia Bash / jq

```bash
jq '.results[0].transcriptLanguages' metadata.json
```

- [Pilih suatu trek judul](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md#captions)

#### YouTube Download

Baca tanda terima delivery.json yang telah selesai. Unduh objek dengan dokumen destination- penyimpanan kredensial, lalu bandingkan ukurannya dan MD5 dengan tanda terima. file_url pribadi tidak menjadi publik setelah pengiriman.

##### PengirimanBash / jq

```bash
jq '.results[0] | {file_url, file_size, md5}' delivery.json
```

- [Verifikasi ukuran dan checksum](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md#delivery)


<a id="mcp"></a>

### MCP alat yang hilang atau otentikasi kadaluwarsa

Periksa host yang menjalankan tugas. Server yang terdaftar menegaskan konfigurasi, bukan koneksi kerja. Jika koneksi OAuth yang dikonfigurasi memerlukan login, jalankan perintah login dan persetujuan peramban lengkap, kemudian segarkan daftar alat.

#### Codex

Buka /mcp dalam Codex CLI untuk memeriksa status koneksi dan alat-alat. Dalam aplikasi, periksa konfigurasi server dan mulai sesi baru setelah perubahan setup.

##### Periksa konfigurasi

```bash
codex mcp list
```

##### Hanya ketika OAuth login dibutuhkan

```bash
codex mcp login flashdata --scopes mcp:research
```

- [Codex setup server](https://flashdata.dev/id/docs/integrations/codex/reference.md)

#### OpenClaw

##### Probe server yang dikonfigurasi

```bash
openclaw mcp doctor flashdata --probe
```

##### Hanya ketika OAuth login dibutuhkan

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```

- [OpenClaw setup server](https://flashdata.dev/id/docs/integrations/openclaw/reference.md)

#### API kunci / server lokal

Masuk OAuth tidak memperbaiki sambungan kunci API-. Periksa kunci dalam lingkungan host dan hak sumbernya. Untuk stdio lokal, periksa paket MCP paket Node.js persyaratan dan restart host setelah memperbarui lingkungannya.

##### Untuk stdio lokal

```bash
node --version
```

- [Kunci API-key host dan setup MCP lokal](https://flashdata.dev/id/docs/integrations/mcp-clients/reference.md)


<a id="skills"></a>

### Skill terpasang tetapi agen tidak dapat menemukan atau menggunakannya

Periksa proyek yang sama, profil host dan lokasi instalasi, kemudian mulai sesi agen baru. CLI keterampilan tugas membutuhkan CLI; flashdatta -mcp membutuhkan koneksi MCP server. Memasang keterampilan tidak menghubungkan server atau memberikan ijin akun.

#### Codex · CLI keterampilan

##### Periksa bundel keterampilan CLI baku

```bash
flashdata skills verify --agent codex
```


#### Codex · MCP keterampilan

##### Periksa hanya pilihan keterampilan MCP

```bash
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### OpenClaw

##### Periksa ketersediaan keterampilan

```bash
openclaw skills list --eligible
openclaw skills check
```


- [Pasang atau perbarui kemampuan](https://flashdata.dev/id/docs/guides/agent-skill/reference.md)
- [Hubungkan MCP](https://flashdata.dev/id/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>

## Pertanyaan yang sering ditanyakan


<a id="faq-access"></a>

### Mendapatkan terhubung

| Pertanyaan | Jawab |
| --- | --- |
| Apa aku butuh agen AI? | Tidak. Gunakan HTTP API, Go/Python/TypeScript SDK, CLI atau konsol secara langsung. MCP dan keterampilan adalah pilihan tambahan bagi agen. |
| Antarmuka mana yang harus kupilih? | Gunakan SDK atau HTTP API di dalam aplikasi, CLI untuk tugas terminal, dan MCP untuk MCP-tuan rumah yang mampu. Keterampilan menyediakan instruksi baik untuk tugas CLI maupun perangkat MCP yang tersambung; mereka tidak mengganti otentikasi. |
| Dapatkah saya menggunakan kembali kredensial untuk tugas yang berulang? | Ya. Gunakan akses pemilik dan melestarikan profil CLI yang dilindungi sama, rahasia runtime atau koneksi MCP. Untuk API-key akses, periksa recurringAllowed: true. Host Anda atau penjadwalan menjalankan jadwal. |
| Apakah menghapus pengaturan lokal mencabut akses? | Tidak. Mengembalikan kunci API atau koneksi di konsol. Menghapus pengaturan lokal hanya menghapus salinan lokal tersebut. |

- [Pilih antar muka](https://flashdata.dev/id/docs/reference.md)
- [Pengaturan ulang tugas](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)
- [Agen yang terhubung](https://flashdata.dev/app/settings/connections)

<a id="faq-billing"></a>

### Ujian dan kredit

| Pertanyaan | Jawab |
| --- | --- |
| Bisakah seorang agen mencoba FlashData sebelum mendaftar? | Ya, dengan akses sementara yang memenuhi syarat melalui CLI atau onboarding API. Gunakan kembali profil dan bukti registrasi yang sama. Penggunaan terus-menerus perlu diklaim atau pemilik yang ada kunci API. |
| Apakah mengklaim menambahkan test grant? | Klaiming sendiri tidak memberikan kredit percobaan tambahan. Permintaan Future menggunakan saldo akun pemilik; kredit sementara yang tidak digunakan tidak transfer. Sebuah akun baru dibuat mengikuti kebijakan normal kredit. |
| Berapa banyak permintaan yang bisa menutupi kreditku? | Periksa saldo akun dan harga sumber. Permintaan tergantung pada sumber, dan gabungan tugas sumber berbagi satu keseimbangan. YouTube Download bernilai oleh byte yang diunduh, bukan jumlah permintaan tetap. |

- [Uji coba dan penautan akun](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md)
- [Hitung jumlah permintaan](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md)
- [Pendaftaran dan batas permintaan](https://flashdata.dev/id/docs/guides/usage-and-limits/reference.md)

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

### Sumber dan hasil

| Pertanyaan | Jawab |
| --- | --- |
| Mengapa agenku mencari tapi tidak mengunduhnya? | Unduh membutuhkan akses pemilik, youtube_download izin dan penyimpanan tujuan. Percobaan sementara dan mcp:research OAuth tidak termasuk Unduhan. Pemilik yang berwenang API kunci dapat menggunakannya melalui CLI, HTTP atau MCP. |
| Apakah Google Search kembali halaman web penuh? | Ini mengembalikan hasil pencarian dan kutipan. Aplikasi atau agen Anda membaca URLs terpilih. |
| Apakah FlashData menghasilkan video ringkasan atau takarsi? | Ini mengambil metadata dan keterangan yang ada. Ini tidak menghasilkan takarir yang hilang; model Anda menulis ringkasan dari hasil yang tersedia. |

- [Google Search](https://flashdata.dev/id/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)

<a id="support"></a>

## Masih terjebak? Kirim laporan minimal

Simpan HTTP kesalahan badan atau CLI JSON kesalahan dari stderr sebagai diagnostic.json. Ekstrak pengidentifikasi hanya setelah perintah gagal. Simpan kunci, teks kueri pribadi dan ditandatangani URLs keluar dari laporan. Untuk non-JSON Respon, laporkan HTTP status dari diagnostic-status.txt.

### Menangkap gratis CLI pemeriksaan akses Bash

```bash
flashdata auth status --json 2> diagnostic.json
```

### Ekstrak identifikasi kesalahan Bash / jq

```bash
# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
  status: ($e.httpStatus // $e.status),
  code: $e.code,
  requestId: $e.requestId,
  runId: (.runId // $e.runId),
  jobId: $e.remoteId,
  retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.json
```

### Laporan dukungan

```text
Waktu UTC:
Klien + versi:
Source + stage (auth / submit / poll / fetch):
HTTP status + kode error:
Permintaan ID / job ID / run ID:
Hasil submission: diterima / ditolak / tidak diketahui
Diduga vs hasil aktual:
```

- [Referensi Error- code](https://flashdata.dev/id/docs/errors/reference.md)
- [Hubungi dukungan](https://flashdata.dev/id/contact)
