# API khởi chạy nhanh

nhỏ Google Search và YouTube ADI trực tiếp trên HTTP. Gửi một yêu cầu và đọc JSON Đáp ứng; không SDK là yêu cầu.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/http-quickstart
Xem lại: 2026-11-04 by FlashData

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

## Tạo yêu cầu HTTP đầu tiên

Đặt API Chìa khóa, gửi một cái. Google Tìm kiếm và kiểm tra phản ứng đã được lưu.


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

### Xác thực

Tạo một tài khoản, kiểm tra email của bạn và tạo một phím bằng Google Search Cho phép. Bạn có thể dùng lại một phím đã có.

Chạy trong terminal và dán khóa vào lời nhắc nhập ẩn. Bỏ qua nếu FLASHDATA_API_KEY đã được đặt.

#### Bash

##### Đặt khóa

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

##### Đặt khóa

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


- [Tạo tài khoản](https://flashdata.dev/signup)
- [Mở API Keys](https://flashdata.dev/app/api-keys)
- [Xác thực tác nhân](https://flashdata.dev/auth.md)

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

### Chạy tìm kiếm

Chọn một khách hàng và chạy ví dụ trong cùng một thiết bị cuối. Mỗi người gửi một cái POST yêu cầu https://data.flashdata.dev/v1/queries/realtime và in ra JSON. Xác thực với X-API-Key; gửi JSON có Content-Type: application/json.

#### cURL

cURL 7.76+ · Bash trên Linux, macOS hay Git Bash. Dán và chạy.

##### Tìm kiếm # 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+ · Dán PowerShell Chỉ huy.

##### Tìm kiếm # 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+ · Lưu dạng search.mjs và chạy trên máy chủ hoặc máy chủ. Sử dụng có sẵn thu thập; không npm cài đặt.

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

##### Chạy · JavaScript

```bash
node search.mjs
```


#### Python

Python 3.10+ · Lưu dạng search.py. Dùng chỉ thư viện chuẩn; không cài đặt pip. Dùng python3 hoặc py -3 Nếu đó là của bạn Python Chỉ huy.

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

##### Chạy · Python

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



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

### Kiểm tra kết quả

Xác nhận HTTP Thành công và status: done. Đọc tiêu đề nguồn, liên kết và trích đoạn vào results[].organicvà trách nhiệm ở usage.credits.

Một danh sách kết quả hoặc hữu cơ rỗng status: done là kết quả rỗng hợp lệ.

| Tìm kiếm | Dùng nó đi |
| --- | --- |
| status | "done" xác nhận việc truy vấn đã thành công. |
| results[0].organic[] | Kết quả. Kiểm tra kết quả là chưa có kết quả trước khi chỉ mục nó. |
| title / link / snippet | Tựa nguồn, URL và trích đoạn. |
| usage.credits | Các tín dụng thực sự được tính vào yêu cầu này. |

#### Câu trả lời mẫu

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

## @ info/ rich

Để nắm bắt yêu cầu tiếp theo, thêm những tùy chọn này vào cURL ra lệnh ở trên. Kiểm tra các tập tin trước khi quyết định thử lại một yêu cầu sai.

### cURL

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

- [HTTP lỗi và phục hồi](https://flashdata.dev/vi/docs/errors/reference.md)

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

## Kiểm tra truy cập và tín dụng

Những GET yêu cầu đọc danh tính, số dư và giá trị mà không cần dùng thẻ truy vấn. Mong đợi HTTP 200 và kiểm tra cánh đồng bên dưới trước khi nộp tiền.

Tài khoản ghi: https://api.flashdata.dev/v2. Yêu cầu dữ liệu: https://data.flashdata.dev/v1. Cả hai đều dùng X-API-Key; JSON POST yêu cầu cũng được dùng Content-Type: application/json.

| Đọc | Những gì để kiểm tra trong phản ứng |
| --- | --- |
| identity | Xác nhận mục đích accountId, access: "ready"ống kính "google_search"và bất kỳ expiresAt. accountType là "owned" cho một chìa khóa chủ sở hữu hoặc "temporary" cho một cái chìa khóa thử nghiệm. |
| balance | Đọc availableCredits. Tất cả các chìa khóa của tài khoản này sử dụng cùng một sự số dư. |
| pricing | Đối với prices[0], xác nhận nguồn là google_search và sẵn sàng là true. So sánh estimatedCredits Vì requestCount: 1 có availableCredits. Giá cả và sự cân bằng có thể thay đổi trước khi phục tùng. |

### Bash / cURL

#### Kiểm tra miễn phí # 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

#### Kiểm tra miễn phí # 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>

## Bước kế

- [Google Search Thực hành tốt nhất](https://flashdata.dev/vi/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)
- [Tham chiếu API](https://flashdata.dev/vi/docs/api-reference/reference.md)
- [Đặc tả OpenAPI](https://flashdata.dev/docs/openapi.json)

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

## Nếu một bước không thành công

Hãy đọc câu trả lời được in trong thiết bị cuối. JavaScript và Python báo cáo HTTP lỗi và Retry-After phải stderr. Mỗi ví dụ đệ trình một lần; nó không tự động thử lại.

| Triệu chứng | Hành động tiếp theo |
| --- | --- |
| Lệnh mất hay tùy chọn không được hỗ trợ | Kiểm tra phiên bản cần thiết trong ví dụ đã chọn. Dùng PowerShell 7 thay vì Windows PowerShell 5.1hoặc dùng Bash có cURL 7.76+. JavaScript Cần nút 22+; Python cần 3.10+. Cài đặt thời gian chạy bị mất từ trang tải về chính thức, mở lại thiết bị cuối, sau đó đặt lại chìa khóa. |
| Thiếu chìa khóa / 401 | Đặt FLASHDATA_API_KEY trong tiến trình này và kiểm tra lại danh tính. Cung cấp đầy đủ năng lượng API Chìa khóa, không có tiền tố. Nếu nó hết hạn hoặc bị thu hồi, hãy sử dụng một chứng nhận có thẩm quyền hiện thời; đừng dán nó vào bộ đàm. |
| 403 | Kiểm tra identity.scopes Vì google_search và tiếp cận sẵn sàng. Yêu cầu sự cho phép bị mất tích của chủ sở hữu; thay đổi nguồn trong yêu cầu không cho phép truy cập. |
| 402 | Hãy đọc lại sự số dư và so sánh nó với giá hiện tại. Chủ sở hữu có thể xem xét Billing. Một thử nghiệm kiệt sức cần người chủ tiếp cận thông qua việc tuyên bố; tạo ra một phiên tòa thay thế không phải là hồi phục. |
| 400 / 422 | Hãy đọc thông điệp lỗi đã được trả lại. Kiểm tra chính xác máy dữ liệu, POST Phương pháp, Content-Type và JSON tên thực địa. Dùng trích dẫn thẳng và số params.numVậy thì hãy sửa lại lời yêu cầu bị từ chối. |
| 429 | Tôn trọng Retry-After nếu có mặt; nếu không hãy dùng một sự lùi lại bị hạn chế và giảm sự nhất trí. Đừng lặp lại nhanh chóng, hãy tạo những phím mới hoặc đăng ký một thử nghiệm khác để vượt qua giới hạn. |
| HTTP 200 với trạng thái hoặc lỗi thất bại | Đọc lỗi trong cơ thể và bảo tồn bất kỳ yêu cầu hay công việc nào ID. Không được phân tích JSON Cơ thể là một nhiệm vụ thành công hoặc tự động phục hồi nó. |
| Kết quả trống | Nếu tình trạng đã được thực hiện, việc xác thực đã hoạt động. Giữ kết quả rỗng hoặc thử truy vấn rộng hơn là yêu cầu trả lương mới. |
| Thời hạn, mất kết nối, 5xx hoặc HTML thay vì JSON | A POST Có lẽ người ta đã chấp nhận ngay cả khi không có phản ứng gì. Kiểm tra History cho yêu cầu gốc và bảo tồn bất kỳ trả về nào IDs trước khi quyết định thay đổi. Tự do GET Có thể lấy lại tiền kiểm tra. Xác nhận URL sử dụng data.flashdata.devkhông phải máy nơi Mạng, cũng không tắt khả năng thẩm tra hệ điều hành của hệ thống phụ thuộc. |

- [Yêu cầu lịch sử](https://flashdata.dev/app/jobs)
- [Quản lý khóa](https://flashdata.dev/app/api-keys)
- [cURL tải về](https://curl.se/download.html)
- [Cài đặt PowerShell](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
- [Node.js tải về](https://nodejs.org/en/download)
- [Python tải về](https://www.python.org/downloads/)
