# API швидкийстарт

Зателефонуйте Google Search та YouTube API безпосередньо над HTTP. Відправити запит і читати JSON відповідь; SDK обов'язковий.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/http-quickstart
Переглянуто: 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 і запустіть локально або на сервері. Використання вбудованої fetch; без встановлення 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/uk/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/uk/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/uk/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/uk/docs/guides/youtube-download-guide/reference.md)
- [Довідник API](https://flashdata.dev/uk/docs/api-reference/reference.md)
- [Специфікація OpenAPI](https://flashdata.dev/docs/openapi.json)

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

## Якщо крок не зникає

Прочитайте відповідь, надана в терміналі. JavaScript і Python звіт HTTP помилки і Retry-After до stderr. Кожен приклад подає один раз; він не автоматично переробляє.

| Симптом | Попередня дія |
| --- | --- |
| Відсутня або не підтримується опція | Перевірити необхідну версію в обраному прикладі. Використовуйте 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 як успішне завдання або автоматично відмініть його. |
| Зручні результати | У разі виконання статусу, автентифікації працювала. Зберігайте порожній результат або спробуйте більш широкий запит, як новий платний запит. |
| Час, з'єднання втрат, 5xxx або HTML замість JSON | А.А. 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/)
