Przeglądaj dokumentację
Pierwsze kroki
Wykonaj pierwsze wyszukiwanie Google i uzyskaj uporządkowane wyniki dla aplikacji lub agenta AI.
Zacznij ze swoim agentem AI
Przekaż ten prompt agentowi z dostępem do terminala. Skonfiguruje FlashData i wykona jedno wyszukiwanie.
Przeczytaj https://flashdata.dev/auth.md i wykonaj instrukcje konfiguracji FlashData dla tego środowiska. Wykorzystaj istniejący dostęp; jeśli go nie ma, rozpocznij tylko jeden okres próbny, o ile spełniasz warunki. Wyszukaj w Google "battery recycling research", pobierając maksymalnie pięć wyników. Zwróć tytuły źródeł, adresy URL i faktycznie zużyte kredyty. Przechowuj dane uwierzytelniające w chronionym magazynie, nigdy na czacie. Jeśli dostęp jest zablokowany, wskaż następny krok zamiast tworzyć kolejny okres próbny.
Wykonaj pierwsze wywołanie API
Wolisz napisać kod samodzielnie? Wykonaj te trzy kroki w terminalu.
Uzyskaj klucz API
Utwórz konto, potwierdź e-mail i utwórz klucz z uprawnieniem Google Search. Jeśli masz już taki klucz, użyj go ponownie.
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_KEYUstaw klucz# 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 flashdataSecureKeyWykonaj wyszukiwanie
Wybierz język i uruchom przykład w tym samym terminalu. Każde uruchomienie wysyła jedno wyszukiwanie.
Python 3.10+ · Zapisz przykład jako quickstart.py.
Zainstalujpython -m pip install "flashdata==1.1.0"quickstart.pyimport json import os from flashdata import FlashData with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client: response = client.google.search("battery recycling research", num=5) if response["status"] != "done": raise RuntimeError(response) print(json.dumps(response, indent=2))Uruchompython quickstart.pyNode.js 22.18+ · Zacznij w pustym folderze i zapisz quickstart.mts.
Skonfigurujnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mtsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Uruchomnode quickstart.mtsNode.js 22+ · Zacznij w pustym folderze i zapisz quickstart.mjs.
Skonfigurujnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mjsimport { FlashData } from '@flashdata-dev/sdk'; const apiKey = process.env.FLASHDATA_API_KEY; if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.'); const client = new FlashData({ apiKey }); const response = await client.google.search({ query: 'battery recycling research', num: 5, }); if (response.status !== 'done') throw new Error(JSON.stringify(response)); console.log(JSON.stringify(response, null, 2));Uruchomnode quickstart.mjsGo 1.25+ · Zacznij w pustym folderze i zapisz main.go. Pomiń go mod init w istniejącym module.
Skonfigurujgo mod init example.com/flashdata-quickstart go get github.com/flashdatadev/[email protected]main.gopackage main import ( "context" "encoding/json" "log" "os" "time" flashdata "github.com/flashdatadev/flashdata-go" ) func main() { key := os.Getenv("FLASHDATA_API_KEY") if key == "" { log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.") } client, err := flashdata.New(flashdata.Options{APIKey: key}) if err != nil { log.Fatal(err) } ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) defer cancel() result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{ Query: "battery recycling research", Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))}, }) if err != nil { // Do not automatically resubmit an uncertain paid request. log.Fatal(err) } if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { log.Fatal(err) } if result.Status != "done" { log.Fatalf("Search did not complete: %s", result.Status) } }Uruchomgo run .SDK nie jest potrzebne. Uruchom polecenie Bash / cURL 7.76+ albo polecenie PowerShell 7.
Bash / cURLcurl --fail-with-body --silent --show-error \ --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$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest $flashdataResult | ConvertTo-Json -Depth 20Sprawdź wynik
Poprawna odpowiedź ma status: done. Źródła są w results[].organic, a naliczone kredyty w usage.credits.
Przykładowa odpowiedź (skrócona){ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }
Wypróbuj konsolę
- Utwórz konto lub się zaloguj. Potwierdź e-mail i wykonaj kroki konfiguracji konta widoczne w konsoli.
- Otwórz Google Search, wybierz źródło Google Search i tryb Realtime, a następnie wpisz battery recycling research. Rozwiń Additional parameters i ustaw Page size (num) na 5.
- Sprawdź widoczne żądanie i dostępne kredyty, a następnie wykonaj wyszukiwanie raz.
- Sprawdź odpowiedź i zużycie. Otwórz zwrócone źródło i sprawdź jego treść, zanim zacytujesz więcej niż fragment.
Rozwiń pierwszy rezultat
Gdy pierwsze żądanie się nie powiedzie
- Brak FLASHDATA_API_KEY
- Ustaw klucz w tym samym terminalu lub środowisku, w którym uruchamiasz przykład. Te fragmenty nie wczytują plików .env.
- 401 / 403
- Sprawdź, czy klucz lub połączenie jest aktywne i ma uprawnienie google_search.
- 402
- Sprawdź dostępne kredyty w Billing. Powiąż istniejący dostęp próbny z kontem, jeśli potrzebujesz dostępu właściciela.
- 429
- Przestrzegaj Retry-After. Zachowaj tę samą tożsamość i dowód rejestracji; nie twórz kolejnego dostępu próbnego.
- Przekroczenie czasu lub nieznany stan wysłania
- Przed ponowieniem sprawdź istniejące uruchomienie. Użytkownicy CLI powinni zachować ten sam profil i identyfikator uruchomienia; użytkownicy SDK/API — zwrócony identyfikator zadania lub żądania.