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

Pierwsze kroki

Nagłówki i uwierzytelnianie

Użyj właściwego hosta i danych uwierzytelniających, a następnie sprawdź dostęp jednym bezpłatnym żądaniem.

Na tej stronie

Podstawa URLs

CelPodstawa URLUwierzytelnianie
Zapytania o dane i miejsca pracyhttps://data.flashdata.dev/v1X-API-Key
Tożsamość, równowaga, ceny, ograniczenia i wykorzystaniehttps://api.flashdata.dev/v2X-API-Key
Zdalne MCPhttps://data.flashdata.dev/mcpZarządzanie host- OAuth lub X-API-Key

Nagłówki uwierzytelniania

Żądania REST używać X-API-Key z kluczem próbnym lub właściciela. Wyślij ciała JSON z Content-Type: application/json. Profile CLI, środowiska SDK i połączenia MCP oddzielnie przechowują referencje.

Poproś nagłówki
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

Sprawdź swój klucz

Sprawdź to w terminalu. Punkt końcowy identyfikacji sprawdza dostęp bez wydawania kredytów. Pomiń sygnał, jeśli FLASHDATA_API_KEY jest już ustawiony.

Wymaga Bash i cURL 7.76 +. Pomiń ukryty sygnał, jeśli Twoje środowisko już dostarcza FLASHDATA_API_KEY. Uruchom polecenia odczytu w tym samym terminalu.

Ustaw klucz · skip, jeśli jest już skonfigurowany
# 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
Czytaj konto JSON
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)

Oczekiwana odpowiedź

Oczekuj HTTP 200. Sprawdź zamierzone konto, access: ready i swoje źródło w skopach. Tymczasowy klucz ma accountType: temporary; powtarzające się prace właściciela wymaga recurringAllowed: true.

Tożsamość właściciela · Ilustracyjny fragment odpowiedzi
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

Składowanie podpisane URLs

Rezultat i przesłać URLs zawiera ich własną autoryzację. Podążaj za zwróconym URL bez X-API-Key, żetonów OAuth lub plików cookie przeglądarki.

Uwierzytelnianie rozwiązywania problemów

OdpowiedźNastępny krok
401Sprawdź klucz w tym środowisku, jego wygaśnięcie i cofnięcie. Użyj aktualnego klucza API, a nie symbolu MCP lub przedrostka Berera.
Brak 403 / źródłoPoproś właściciela o podanie wymaganego źródła tego klucza.
503 na tej bezpłatnej lekturzePóźniej pobierz odczyt. Status konta nie został zweryfikowany; nie należy wywnioskować, że płatne zapytanie jest gotowe.