# Cepatstart cepat API

Niapolis Call Google Search dan YouTube API langsung melalui HTTP. Kemudia mengirim satu permintaan dan membaca respon JSON; tidak ada SDK yang diperlukan.

Referensi boonical: https://flashdata.dev/ms/docs/guides/http-quickstart
Diulas: 2026-11-04 oleh FlashData

<a id="application"></a>

## Buat permintaan HTTP pertamamu

Tetapkan kunci API, kirim satu pencarian Google dan periksa respon tersimpan.


<a id="prepare"></a>

### Autentifikasi

Buat akun, periksa email Anda dan buat kunci dengan izin Google Search. Anda dapat menggunakan kembali kunci yang ada.

Jalankan dalam terminal dan tampal kunci apabila diminta; input akan disembunyikan. Langkau jika FLASHDATA_API_KEY sudah ditetapkan.

#### Bash

##### Tetapkan kunci anda

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### Tetapkan kunci anda

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Cipta akaun](https://flashdata.dev/signup)
- [Buka API Keys](https://flashdata.dev/app/api-keys)
- [Autentikasi Agen Agensi](https://flashdata.dev/auth.md)

<a id="curl"></a>

### Jalankan carian

Ifinder memilih klien dan menjalankan contoh di terminal yang sama. Tiap-tiapnya mengirimkan satu permintaan POSTQ ke https://data.flashdata.dev/v1/queries/realtime dan mencetak JSON. Otentikasi dengan X-API-Key; kirim JSON dengan Content-Type: application/json.

#### cURL

cURL 7.76+ · Bash Pada Linux, macOS OR atau ORANG Git Bash. Kita pergi dan lari.

##### Cari · Bash / cURL

```bash
curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}'
```


#### PowerShell 7

PowerShell 7+ · Tempel perintah PowerShell asli ini.

##### Cari · PowerShell

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataSearch = @{
  Uri = 'https://data.flashdata.dev/v1/queries/realtime'
  Method = 'Post'
  Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  ContentType = 'application/json'
  Body = $flashdataRequest
  TimeoutSec = 70
  MaximumRedirection = 0
  SkipHttpErrorCheck = $true
  ErrorAction = 'Stop'
}
$flashdataResponse = Invoke-WebRequest @flashdataSearch
$flashdataResponse.Content
if ($flashdataResponse.StatusCode -ge 400) {
  throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying."
}
```


#### JavaScript

Node.js 22· Simpan sebagai search.mjs Anda dan lari ke lokal atau ke server Anda. Guna pengambilan bawaan; tidak ada pemasangan npm.

##### search.mjs

```javascript
const key = process.env.FLASHDATA_API_KEY;
if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal.");

let response;
try {
  response = await fetch("https://data.flashdata.dev/v1/queries/realtime", {
    method: "POST",
    redirect: "error",
    signal: AbortSignal.timeout(70000),
    headers: { "X-API-Key": key, "Content-Type": "application/json" },
    body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}),
  });
} catch {
  throw new Error("Request did not complete. Check History before resubmitting.");
}

const body = await response.text();
console.log(body); // Print the full response before checking its status.
if (!response.ok) {
  const retryAfter = response.headers.get("retry-after");
  throw new Error("HTTP " + response.status + ". See the response above." +
    (retryAfter ? " Retry-After: " + retryAfter : ""));
}
let result;
try {
  result = JSON.parse(body);
} catch {
  throw new Error("Expected JSON. Inspect the response above and the API URL.");
}
if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) {
  throw new Error("Query did not succeed. Inspect status and error in the response above.");
}
```

##### Jalankan · JavaScript

```bash
node search.mjs
```


#### Python

Python 3.10+ · Simpan sebagai search.py. Hanya menggunakan perpustakaan standar; tidak ada pemasangan pip. Anda menggunakan python3 atau py -3 jika itu adalah perintah Python Anda.

##### search.py

```python
import json
import os
import urllib.error
import urllib.request

key = os.environ.get("FLASHDATA_API_KEY")
if not key:
    raise SystemExit("Set FLASHDATA_API_KEY in this terminal.")

# Do not forward the API key to a redirect destination.
class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

request = urllib.request.Request(
    "https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"),
    headers={"X-API-Key": key, "Content-Type": "application/json"},
    method="POST",
)
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response:
        body = response.read().decode("utf-8")
except urllib.error.HTTPError as error:
    print(error.read().decode("utf-8", errors="replace"))
    retry_after = error.headers.get("Retry-After")
    raise SystemExit("HTTP " + str(error.code) + ". See the response above." +
                     (" Retry-After: " + retry_after if retry_after else ""))
except (urllib.error.URLError, TimeoutError):
    raise SystemExit("Request did not complete. Check History before resubmitting.")

print(body)  # The run command saves this full response to result.json.
try:
    result = json.loads(body)
except json.JSONDecodeError:
    raise SystemExit("Expected JSON. Inspect the response above and the API URL.")
if (not isinstance(result, dict) or result.get("error") is True
        or result.get("status") != "done" or not isinstance(result.get("results"), list)):
    raise SystemExit("Query did not succeed. Inspect status and error in the response above.")
```

##### Jalankan · Python

```bash
python -X utf8 search.py
```



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

### Semak hasil

Konfirmasi keberhasilan HTTP dan status: done. Type, link dan snippet dalam results[].organic, dan muatan dalam usage.credits.

Hasil kosong atau daftar organik dengan status: done adalah hasil kosong yang valid.

| Ukrainian | Gunalah untuk |
| --- | --- |
| status | "done" konfirmasi bahwa pertanyaan tersebut berhasil diselesaikan. |
| results[0].organic[] | Hasil pencarian mayat. Periksa bahwa hasil tidak kosong sebelum mengindeksnya. |
| title / link / snippet | Gelar Sumber, URL dan kutipan. |
| usage.credits | Kredit aktual yang dibebankan untuk pertanyaan ini. |

#### Contoh respons

```json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="diagnostics"></a>

## Simpan respon untuk debug

Untuk menangkap permintaan selanjutnya, tambahkan pilihan ini ke perintah cURL di atas. Periksa berkas sebelum memutuskan untuk mencoba kembali permintaan yang gagal.

### cURL

```bash
--dump-header response-headers.txt --output result.json
```

- [Kesalahan dan pemulihan HTTP](https://flashdata.dev/ms/docs/errors/reference.md)

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

## Periksa akses akses dan kredit

Kekhalifahan GET ini meminta untuk membaca identitas, keseimbangan dan pricing tanpa menggunakan kredit kueri. Expect HTTP 200 dan periksa bidang-bidang di bawah ini sebelum menyerahkan pekerjaan berbayar.

Akun baca: https://api.flashdata.dev/v2. Permintaan data permintaan bantuan: https://data.flashdata.dev/v1. Keduanya menggunakan X-API-Key; Permintaan JSON POST juga menggunakan Content-Type: application/json.

| Bacalah | Apa yang harus diperiksa sebagai tanggapan |
| --- | --- |
| identity | Kepastian accountId, access: "ready", skop berisi "google_search", dan expiresAt. accountType adalah "owned" untuk kunci pemilik atau "temporary" untuk kunci percobaan. |
| balance | Baca availableCredits. Semua kunci untuk akun ini menggunakan keseimbangan yang sama. |
| pricing | Untuk harga yudien[0], konfirmasi sumber adalah google_search dan tersedia adalah true. Bandingkan estimatedCredits untuk requestCount: 1 dengan availableCredits. Harga dan keseimbangan dapat berubah sebelum penyerahan. |

### Bash / cURL

#### Pemeriksaan gratis · Bash

```bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
```


### PowerShell 7

#### Pemeriksaan gratis · PowerShell

```powershell
try {
  foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
    Write-Host $flashdataPath
    $flashdataRead = @{
      Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
      Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
      TimeoutSec = 20
      MaximumRedirection = 0
      ErrorAction = 'Stop'
    }
    Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
  }
} catch {
  throw
}
```



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

## Langkah - langkah selanjutnya

- [Praktik terbaik Google Search](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)
- [Rujukan API](https://flashdata.dev/ms/docs/api-reference/reference.md)
- [Spesifikasi klash](https://flashdata.dev/docs/openapi.json)

<a id="troubleshooting"></a>

## Jika langkah gagal

Bacalah tanggapan yang dicetak di terminal Anda. JavaScript dan Python melaporkan kesalahan HTTP dan Retry-After ke stderr. Setiap contoh satu kali tunduk; ia tidak secara otomatis mencoba kembali.

| Symptom | Tindakan berikutnya |
| --- | --- |
| Perintah command hilang atau pilihan tidak didukung | Semak versi yang diperlukan dalam contoh pilihan. Gunakan PowerShell 7, bukannya Windows PowerShell 5.1, atau gunakan Bash dengan cURL 7.76+. JavaScript memerlukan Node 22+; Python memerlukan 3.10+. Pasang runtime yang belum tersedia daripada halaman muat turun rasminya, buka semula terminal dan tetapkan kunci sekali lagi. |
| Kunci hilang / 401 | Diagonia Set FLASHDATA_API_KEY dalam proses ini dan memeriksa identitas lagi. Bekalkan kunci API aktif penuh, tanpa awalan Bearer. Jika sudah kadaluarsa atau dicabut, gunakan kredensial yang sah saat ini; jangan tampal ke dalam chat. |
| 403 | Periksa identity.scopes untuk google_search dan akses untuk siap. Meminta izin yang hilang dari pemilik; mengubah sumber dalam permintaan tidak memberikan akses. |
| 402 | Baca keseimbangan lagi dan bandingkan dengan harga saat ini. owner dapat meninjau Billing. Pencobaan yang kelelahan membutuhkan akses pemilik melalui klaim; menciptakan pengadilan pengganti bukanlah pemulihan. |
| 400 / 422 | Baca pesan kesalahan yang dikembalikan. Periksa host data yang tepat, metode POST, Content-Type dan JSON. Gunakan kutipan lurus dan params.num numerik, kemudian benar permintaan yang ditolak. |
| 429 | Ospect Retry-After jika hadir; jika tidak gunakan backoff terikat dan mengurangi konkurensi. Jangan berputar cepat, membuat kunci baru atau mendaftarkan uji coba lain untuk melewati batas. |
| HTTP 200 gagal pada status atau error | Dia membaca kesalahan dalam tubuh dan menjaga setiap permintaan atau pekerjaan ID. Jangan perlakukan badan JSON yang terurai sebagai tugas yang sukses atau secara otomatis mengirimkannya kembali. |
| Hasil Kosong | Jika status sudah selesai, pengesahan berhasil. Simpan hasil kosong atau coba pertanyaan lebih luas sebagai permintaan berbayar baru. |
| Masa habis, hilang sambungan, 5xx atau HTML daripada JSON | A POST mungkin telah diterima bahkan jika responnya hilang. Cek History untuk pertanyaan asli dan jaga semua IDs yang dikembalikan sebelum memutuskan untuk mengirim kembali. Pemeriksaan GET gratis dapat dicoba ulang. Kepastian URL menggunakan data.flashdata.dev, bukan host situs web, dan tidak lumpuhkan verifikasi TLS. |

- [Sejarah permintaan](https://flashdata.dev/app/jobs)
- [Urus kunci](https://flashdata.dev/app/api-keys)
- [muaturun cURL](https://curl.se/download.html)
- [Pasang PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
- [muaturun Node.js](https://nodejs.org/en/download)
- [muaturun Python](https://www.python.org/downloads/)
