# API เริ่มทํางานเร็ว

เรียก Google Search ถึง YouTube API โดยตรงมากกว่า HTTP. ส่งหนึ่งคําขอและอ่าน JSON ตอบกลับ; ไม่ใช่ SDK มันจําเป็น

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/http-quickstart
Recorder: 2026-11-04 โดย FlashData

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

## ให้เป็นครั้งแรกของคุณ HTTP ร้องขอ

ตั้งค่าของคุณ API กุญแจ, ส่งมาอันนึง Google สืบค้นและตรวจสอบการตอบสนองที่บันทึกไว้


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

### การตรวจสอบสิทธิ์

สร้างบัญชีผู้ใช้, ตรวจสอบอีเมลของคุณและสร้างกุญแจด้วย Google Search อนุญาต คุณสามารถใช้กุญแจที่มีอยู่แล้วซ้ําได้

รันในเทอร์มินัลแล้ววางคีย์เมื่อระบบขอ โดยข้อความที่ป้อนจะถูกซ่อน ข้ามขั้นตอนนี้หากตั้งค่า FLASHDATA_API_KEY แล้ว

#### Bash

##### ตั้งค่าคีย์

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

##### ตั้งค่าคีย์

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


- [สร้างบัญชี](https://flashdata.dev/signup)
- [เปิด API Keys](https://flashdata.dev/app/api-keys)
- [การตรวจสอบสิทธิ์ของเจ้าหน้าที่](https://flashdata.dev/auth.md)

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

### เรียกใช้การค้นหา

เลือกไคลเอนต์และเรียกตัวอย่างในเทอร์มินัลเดียวกัน แต่ละคนส่งหนึ่ง POST ร้องขอไป https://data.flashdata.dev/v1/queries/realtime และรอยนิ้วมือ JSON. การตรวจสอบสิทธิ์กับ X-API-Key– ส่ง JSON ด้วย Content-Type: application/json.

#### cURL

cURL 7.76+ · Bash บน Linux, macOS หรือ Git Bash. วางแล้วหนี

##### ค้นหาที่ '' 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+ ที่วางถิ่นนี้ PowerShell คําสั่ง

##### ค้นหาที่ '' 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+ _บันทึกเป็น search.mjs และเรียกใช้งานบนเครื่องหรือบนเซิร์ฟเวอร์ของคุณ ใช้การเรียกข้อมูลที่ถูกสร้างมา ไม่ใช้ 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.");
}
```

##### เรียกใช้เวิร์ด JavaScript

```bash
node search.mjs
```


#### Python

Python 3.10+ _บันทึกเป็น search.py. ใช้เฉพาะไลบรารีมาตรฐานเท่านั้น; ไม่ใช่ pip ติดตั้ง ใช้ python3 หรือ py -3 ถ้านั่นคือของคุณ Python คําสั่ง

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

##### เรียกใช้เวิร์ด Python

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



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

### ตรวจสอบผลลัพธ์

ยืนยัน HTTP สําเร็จและ status: done. อ่านชื่อแหล่ง, ลิงก์ และชิ้นส่วนใน results[].organicและค่าใช้จ่ายใน usage.credits.

ผลที่ว่างเปล่าหรือรายการออแกนิกที่มี status: done เป็นผลลัพธ์ที่ว่างอยู่

| ช่องข้อมูล | ใช้มันเพื่อ |
| --- | --- |
| status | "done" ยืนยันการสืบค้นเสร็จสิ้น |
| results[0].organic[] | สืบค้นผล ตรวจสอบว่าผลไม่ว่างเปล่าก่อนที่จะทําดัชนี |
| title / link / snippet | ต้นฉบับชื่อ URL และตัดต่อ |
| usage.credits | บัตรเครดิตที่ทําหน้าที่ค่าใช้จ่ายสําหรับการค้นหานี้ |

#### การตอบกลับแบบตัวอย่าง

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

## บันทึกการตอบสนองสําหรับดีบั๊ก

เพื่อจับการร้องขอต่อไป ให้เพิ่มตัวเลือกเหล่านี้ไปยังคําสั่ง cURL แสดงเฉพาะแฟ้มก่อนที่จะตัดสินใจทําการแก้ไขการร้องขอที่ล้มเหลว

### cURL

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

- [HTTP มีข้อผิดพลาดและการกู้คืน](https://flashdata.dev/th/docs/errors/reference.md)

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

## ตรวจสอบสิทธิ์และเครดิต

พวกนี้ GET ร้องขออ่านอัตลักษณ์, สมดุล และราคาโดยไม่ต้องใช้หน่วยกิตสอบถาม คาด HTTP 200 และตรวจสอบสนามข้างล่าง ก่อนที่จะทํางาน

บัญชีผู้ใช้อ่าน: https://api.flashdata.dev/v2. ต้องการข้อมูล: https://data.flashdata.dev/v1. ทั้งคู่ใช้ X-API-Key; JSON POST ร้องขอใช้งานด้วย Content-Type: application/json.

| อ่าน | จะตรวจสอบในการตอบสนอง |
| --- | --- |
| identity | ยืนยันวัตถุประสงค์ accountId, access: "ready"ขอบเขตที่บรรจุ "google_search"และอื่น ๆ expiresAt. accountType คือ "owned" สําหรับกุญแจสําหรับเจ้าของหรือ "temporary" สําหรับกุญแจทดลอง |
| balance | อ่าน availableCredits. กุญแจทั้งหมดของบัญชีนี้ ใช้สมดุลแบบเดียวกัน |
| pricing | สําหรับ prices[0]แหล่งที่มายืนยัน google_search และมีให้ใช้ true. เทียบ estimatedCredits สําหรับ requestCount: 1 ด้วย availableCredits. ค่า ใช้ จ่าย และ ความ สมดุล อาจ เปลี่ยน ไป ก่อน จะ ยอม รับ อํานาจ. |

### Bash / cURL

#### เช็คข้อมูลอิสระ 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

#### เช็คข้อมูลอิสระ 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>

## ถัดไป

- [แนวทางใช้ Google Search](https://flashdata.dev/th/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)
- [เอกสารอ้างอิง API](https://flashdata.dev/th/docs/api-reference/reference.md)
- [ข้อกําหนด OpenAPI](https://flashdata.dev/docs/openapi.json)

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

## ถ้าขั้นตอนล้มเหลว

อ่าน การ ตอบ รับ ที่ พิมพ์ ใน เทอร์มินัล ของ คุณ. JavaScript ถึง Python รายงาน HTTP ผิดพลาดและ Retry-After ถึง stderr. แต่ละตัวอย่างจะส่งหนึ่งครั้ง; มันไม่ได้พยายามใหม่โดยอัตโนมัติ

| Sumpotom | การกระทําถัดไป |
| --- | --- |
| ตัวเลือกของคําสั่งสูญหาย หรือไม่รองรับ | โปรดตรวจสอบรุ่นที่ต้องการในตัวอย่างที่เลือกไว้ ใช้ PowerShell 7 แทนที่จะ Windows PowerShell 5.1หรือใช้ Bash ด้วย cURL 7.76+. JavaScript ต้องการโหนด 22+; Python ต้องการ 3.10+. ติดตั้งเวลาการทํางานที่หายไปจากหน้าดาวน์โหลดอย่างเป็นทางการ เปิดเทอร์มินัลใหม่อีกครั้ง แล้วตั้งค่ากุญแจอีกครั้ง |
| กุญแจหายไป / 401 | ตั้ง FLASHDATA_API_KEY ในโพรเซสนี้และตรวจสอบการแสดงตัวอีกครั้ง เพิ่มข้อมูลที่จะให้ทํางานเต็มที่ API กุญแจ, ไม่มีคํานําหน้าของแบร์ หากมันหมดอายุหรือถูกยกเลิก ใช้สิทธิ์ที่อนุญาตในปัจจุบัน; อย่าวางมันไว้ในการสนทนา |
| 403 | ตรวจสอบ identity.scopes สําหรับ google_search และเข้าได้พร้อม ต้องการสิทธิ์ในการสูญหายจากเจ้าของบ้าน การเปลี่ยนแหล่งในการร้องขอไม่อนุญาตสิทธิ์ |
| 402 | อ่าน สมดุล อีก ครั้ง และ เทียบ กับ ราคา ที่ มี อยู่ ใน ปัจจุบัน. เจ้าของสามารถทบทวน Billing ได้ การ ทดลอง ที่ เหนื่อย ล้า จําเป็น ต้อง มี ผู้ เป็น เจ้าของ โดย อ้าง ว่า ได้ รับ การ ช่วย เหลือ; การ สร้าง การ พิจารณา คดี แทน ไม่ ได้ ฟื้น ตัว. |
| 400 / 422 | อ่านข้อความผิดพลาดที่ส่งกลับมา ตรวจสอบข้อมูลที่แสดง POST วิธี Content-Type ถึง JSON ชื่อสนาม ใช้คําพูดตรงๆ และตัวเลข params.num จากนั้นแก้ไขคําร้องขอที่ถูกปฏิเสธให้ถูกต้อง |
| 429 | นับถือ Retry-After หากมี; มิฉะนั้นใช้การผูกพันกลับและลดความสอดคล้อง ไม่ต้องวนรอบอย่างรวดเร็ว สร้างกุญแจใหม่ หรือลงทะเบียนการทดลองอื่นเพื่อข้ามค่าจํากัด |
| HTTP 200 สถานะหรือข้อผิดพลาดล้มเหลว | อ่านข้อผิดพลาดในร่างกายและรักษาการร้องขอหรืองานใด ๆ ID ไม่ให้ปฏิบัติต่อการวิเคราะห์ JSON ร่าง กาย จะ ทํา งาน ที่ ประสบ ความ สําเร็จ หรือ จะ ทํา การ เปลี่ยน แปลง ใหม่ โดย อัตโนมัติ. |
| ผลการค้นหา: | หากทําสถานะแล้ว การตรวจสอบสิทธิ์ก็ใช้ได้ เก็บผลที่ว่างอยู่ หรือพยายามสอบถามแบบกว้างกว่านี้ เป็นการร้องขอที่ต้องจ่ายใหม่ |
| เวลานอก, การสูญเสียการเชื่อมต่อ, 5x หรือ HTML แทน JSON | A POST อาจจะถูกยอมรับถึงแม้ว่าการตอบรับจะสูญหายก็ตาม ตรวจสอบ History สําหรับการค้นหาต้นฉบับและรักษาการกลับมาใด ๆ IDs ก่อนที่จะตัดสินใจแก้ไขใหม่ ว่าง GET เช็คสามารถตรวจสอบได้ ยืนยัน URL ใช้ data.flashdata.devไม่ใช้โฮสต์ของเว็บไซต์ และไม่ปิดการตรวจสอบความถูกต้องของการเข้ารหัสแบบ TLS |

- [ต้องการประวัติ](https://flashdata.dev/app/jobs)
- [จัดการกุญแจ](https://flashdata.dev/app/api-keys)
- [cURL ดาวน์โหลด](https://curl.se/download.html)
- [ติดตั้ง PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
- [Node.js ดาวน์โหลด](https://nodejs.org/en/download)
- [Python ดาวน์โหลด](https://www.python.org/downloads/)
