Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

Szybki start API

Zadzwoń do API Google Search i YouTube bezpośrednio nad HTTP. Wyślij jedną prośbę i przeczytaj odpowiedź JSON; nie jest wymagane SDK.

  1. Uwierzytelnij

    Utwórz konto, zweryfikuj swój e-mail i utwórz klucz za zgodą Google Search. Możesz ponownie użyć istniejącego klucza.

    Uruchom polecenie w terminalu i wklej klucz w ukrytym polu wejściowym. Pomiń ten krok, jeśli FLASHDATA_API_KEY jest już ustawione.

    Ustaw klucz
    # 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
  2. Wykonaj wyszukiwanie

    Wybierz klienta i uruchom przykład w tym samym terminalu. Każdy z nich wysyła do POST jeden wniosek o wydanie https://data.flashdata.dev/v1/queries/realtime i drukuje JSON. Uwierzytelnij X-API-Key; wyślij JSON Content-Type: application/json.

    cURL 7.76 + · Bash na Linux, macOS lub Git Bash. Wklej i uciekaj.

    Wyszukiwanie · Bash / cURL
    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
      }
    }'
  3. Sprawdź wynik

    Potwierdź sukces HTTP i status: done. Czytaj tytuły źródłowe, odnośniki i snippety w results[].organic, a opłata w usage.credits.

    Pusty wynik lub lista organiczna z status: done jest poprawnym pustym wynikiem.

    Przykład odpowiedzi
    {
      "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
      }
    }
    status
    "done" potwierdza, że zapytanie zostało zakończone pomyślnie.
    results[0].organic[]
    Wyniki wyszukiwania. Sprawdź, czy wyniki nie są puste przed indeksowaniem.
    title / link / snippet
    Nazwa źródła, URL i fragment.
    usage.credits
    Rzeczywiste kredyty naliczane za to zapytanie.

Zapisz odpowiedź dla debugowania

Aby uchwycić następne zamierzone żądanie, dodaj te opcje do polecenia cURL powyżej. Sprawdź pliki przed podjęciem decyzji o ponownym uruchomieniu nieudanego żądania.

cURL
--dump-header response-headers.txt --output result.json

Sprawdzić dostęp i kredyty

Te żądania GET odczytują tożsamość, równowagę i ceny bez korzystania z kredytów zapytania. Oczekuj HTTP 200 i sprawdź pola poniżej przed przedłożeniem płatnej pracy.

Konto czyta: https://api.flashdata.dev/v2. Wnioski o dane: https://data.flashdata.dev/v1. Oba stosuje się X-API-Key; JSON POST wnioski również korzystać Content-Type: application/json.

Bezpłatne kontrole · 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
)
identity
Potwierdź zamierzony accountId, access: "ready", zakresy zawierające "google_search" i wszelkie expiresAt. accountType jest "owned" dla klucza właściciela lub "temporary" dla klucza próbnego.
balance
Przeczytaj availableCredits. Wszystkie klucze do tego konta używają tego samego salda.
pricing
Dla cen [0], potwierdź źródło jest google_search i dostępne jest true. Porównaj estimatedCredits dla requestCount: 1 z availableCredits Ceny i salda mogą ulec zmianie przed złożeniem.

Kolejne kroki

Jeśli krok zawiedzie

Przeczytaj odpowiedź wydrukowaną w terminalu. JavaScript i Python zgłaszają błędy HTTP i Retry-After do stderr. Każdy przykład przedstawia się raz; nie próbuje ponownie automatycznie.

Brak polecenia lub nieobsługiwana opcja
Sprawdź wymaganą wersję w wybranym przykładzie. PowerShell 7 zamiast Windows PowerShell 5.1 lub Bash z cURL 7.76 +. JavaScript potrzebuje Węzła 22 +; Python potrzebuje 3.10 +. Zainstaluj brakującą runtime ze swojej oficjalnej strony pobierania, ponownie otwórz terminal, a następnie ponownie ustaw klucz.
Brak klucza / 401
Ustaw FLASHDATA_API_KEY w tym procesie i sprawdź tożsamość ponownie. Dostarcz pełny aktywny klucz API, bez przedrostka Berera. Jeśli wygasł lub został cofnięty, użyj aktualnego autoryzowanego identyfikatora; nie wklej go do czatu.
403
Sprawdź identity.scopes dla google_search i dostęp do niego. Żądanie brakującego zezwolenia od właściciela; zmiana źródła wniosku nie zapewnia dostępu.
402
Przeczytaj jeszcze raz bilans i porównaj go z bieżącą ceną. Właściciel może przejrzeć Billing. Wyczerpana próba wymaga dostępu właściciela poprzez roszczenie; tworzenie procesu zastępczego nie jest odzyskiwanie.
400 / 422
Odczytaj wiadomość o błędzie. Sprawdź dokładny host danych, metodę POST, Content-Type i nazwy pól JSON. Użyj prostych cytatów i liczbowego params.num, a następnie skorygować odrzucony wniosek.
429
Poszanuj Retry-After, jeśli jest obecny; w przeciwnym razie należy użyć ograniczonego backupu i zmniejszyć współwartość. Nie pętli szybko, tworzyć nowe klucze lub zarejestrować inny proces, aby obejść limit.
HTTP 200 z nieudanym statusem lub błędem
Czytaj błąd w organizmie i zachować wszelkie życzenie lub zadanie ID. Nie należy traktować przepuszczanego ciała JSON jako udanego zadania ani automatycznie go ponownie uśmiercać.
Puste wyniki
Jeśli status jest gotowy, uwierzytelnienie działa. Zachować pusty wynik lub spróbować szersze zapytanie jako nowy wniosek płatny.
Czas, utrata połączenia, 5xx lub HTML zamiast JSON
POST mógł zostać przyjęty nawet jeśli jego odpowiedź została utracona. Zaznacz History dla oryginalnego zapytania i zachowaj zwrócone IDs przed podjęciem decyzji o ponownym odtworzeniu. Darmowe kontrole GET można ponownie spróbować. Potwierdź URL używa data.flashdata.dev, a nie hosta strony internetowej, i nie wyłączaj weryfikacji TLS.