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

Integracje

Opcje uwierzytelniania agenta

Połącz się z kluczykiem API lub MCP OAuth, weryfikuj dostęp bez płatnego zapytania i używaj go do późniejszych zadań.

Na tej stronie

1. Wybierz i podłącz

Już się połączyłeś? Przejdź bezpośrednio do wolnej kontroli w kroku 2. W przeciwnym razie, wybierz dostęp do aplikacji lub agenta potrzebuje.

Łączysz sięStosowanieKto trzyma wiarygodność?
Aplikacja, SDK, CLI lub zaplanowany skryptWłaściciel klucz APISklep tajny serwera lub profil CLI
Narzędzia badawcze Codex lub OpenClawMCP OAuthHost po uzyskaniu zgody przeglądarki
Agent próbujący użyć FlashData bez kontaTymczasowy klucz APIAgent zachował profil próbny, a potem dostęp do właściciela po stwierdzeniu, że

Utwórz klucz w API Keys ze źródłami, których potrzebujesz lub ponownie użyj istniejącego klucza. Dostarcz go do swojego SDK lub wyślij jako X-API-Key ze swojego backendu. W Bash oraz PowerShell Kontrole stopniowe 2 pracować bezpośrednio z API; nie CLI wymagana jest instalacja.

Z jakich źródeł można korzystać?

Stosowanie X-API-Key dla normy HTTP wnioski oraz API- klucz MCP połączenia. Tokeny na okaziciela OAuth działają tylko w punkcie końcowym MCP. YouTube Download potrzebuje właściciela klucza API z youtube_download i miejsca przeznaczenia.

KredytoweDostępne źródła
Właściciel klucz APIŹródła przyznane kluczykowi, w tym youtube_download po zatwierdzeniu.
Tymczasowy klucz APIWyłącznie przyznane źródła kwalifikowane do badania. Odczytywanie sopów z bieżącej odpowiedzi tożsamości.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Zapisz klucz w CLI

Pomiń import, jeśli CLI ma już dostęp lub tajny menedżer dostarcza FLASHDATA_API_KEY. W przeciwnym razie należy wybrać metodę poniżej i zachować ten sam profil badań dla późniejszych poleceń. Zapisany klucz CLI nie jest automatycznie dostępny dla SDK lub lokalnych serwerów MCP.

Wklej klucz na ukrytym terminalu.

Importuj raz
flashdata auth login --profile research

2. Weryfikacja połączenia

Uruchom darmowe sprawdzenie w środowisku, które będzie wykonywać zadanie. Sprawdzanie CLI i HTTP używa klucza API; sprawdzanie MCP używa własnego zapisanego połączenia hosta.

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'
)

Przeczytaj tożsamość klucza API-

Pola tożsamości HTTP są na najwyższym poziomie. W CLI JSON należy przeczytać data.identity.identity i zażądać data.accessVerified: true. HTTP 200 lub CLI ok: true w monoterapii nie wystarczy.

SprawdźWymagany wynik
Przewidywane kontoaccountId i apiKeyId identyfikują konto i klucz, którego chcesz użyć.
Dostęp możliwy do użyciaaccess: ready
Zezwolenie na zadanieSzopy zawierają źródło, takie jak google_search. CLI zawiera również listę dozwolonych źródeł w data.identity.permittedSources.
Powtarzające się zadanieaccountType: owned · installed: true · recurringAllowed: true

Aktywny proces jest poprawnym połączeniem

Próba może przejść jednorazową kontrolę zadania, podczas gdy recurringAllowed jest false. Przeczytaj rzeczywiste zakresy i wygaśnięcie; zażądać istniejącego procesu przed planowaniem pracy.

Tożsamość tymczasowa - pola ilustrujące
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Znajdź połączenie w Codex

Wymień skonfigurowane serwery, a następnie użyj /mcp w świeżej sesji Codex. Uruchom kontrolę MCP powyżej, aby zweryfikować wiarygodność.

Lista serwerów
codex mcp list

Sprawdź połączenie w OpenClaw

Sprawdź zapisany serwer, a następnie uruchom kontrolę MCP powyżej w aktywnej rozmowie.

Sprawdź serwer
openclaw mcp doctor flashdata --probe

3. Ponowne wykorzystanie dostępu do późniejszych zadań

Utrzymuj sklep kredytowy prywatny i trwały w całym procesie restartuje. Recheck dostępu w nowym procesie przed zezwoleniem na terminarza.

KredytoweDo następnego zadania
Właściciel klucz APIPonownie użyj zapisanego klucza. Nie posiada żadnego kroku odświeżania OAuth; należy go zastąpić, jeśli wygasł lub został cofnięty.
MCP OAuthHost odświeża jednogodzinne żetony dostępu OAuth za pomocą obrotowych żetonów odświeżających. Uzupełnić po wygaśnięciu lub cofnięciu grantu na dzień 90-. Każda instalacja jest właścicielem sklepu z żetonami; nie udostępniaj plików z symbolami odświeżania pomiędzy hostami.
Tymczasowy klucz APIWykończ właściciela twierdząc i creditial przekazanie przed powtarzającą się pracą. Ponownie użyj oryginalnego profilu; nie rejestruj się ponownie dla każdego uruchomienia.

Zaznacz zadanie CLI przed planowaniem

Wymaga Bash i jq. Ustaw SOURCE na źródło zadania. Skrypt używa badań domyślnie; ustaw FLASHDATA_PROFILE i FLASHDATA_STATE_DIR dla innego profilu lub katalogu stanu. Wyjście 0 z tożsamością JSON oznacza, że klucz właściciela jest gotowy, zainstalowany i dozwolony dla tego źródła. Niech twój terminarz zatrzyma się na każdym innym wyjściu. Nie jest składane żadne zapytanie.

Sprawdzanie dostępu do nowego procesu · Bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)

Jeśli dostęp jest nadal procesem

Ukończ proces i domagaj się przewodnika z oryginalnym profilem. Po zatwierdzeniu właściciela i przekazaniu uprawnień, bezpłatna kontrola powinna wykazać własny dostęp i recurringAllowed: true. Ciągłe żądania wykorzystują wspólny bilans właściciela; niewykorzystane kredyty próbne nie są przenoszone. MCP OAuth logowanie jest oddzielnym połączeniem i nie rości sobie prawa do tego procesu.

Dostęp ponownie

Najpierw przerwij powtarzające się prace. Odnowić dopasowanie funkcji kredytowej poniżej, a następnie powtórzyć bezpłatny czek ze świeżego procesu lub sesji przed oczyszczeniem lokalnego dostępu. Oczekuj awarii uwierzytelniania lub żądania ponownego połączenia; nie zatwierdzaj nowego połączenia podczas sprawdzania. Samodzielne wylogowanie lokalne nie unieważnia dostępu do serwera.

PołączenieGdzie należy odwołać
MCP OAuthSettings → Connected apps → grant aplikacji.
Zatwierdzony agent API kluczSettings → Connected apps → Połączenia agentów.
Konto API kluczAPI Keys → klucz używany przez tę integrację.

Napraw nieudany sprawdzian

WynikDziałanie
accessVerified: falseFaza odczytu i nextCommand. Profil oczekujący może zwrócić ok: true przed użyciem klucza. Zakończ zapisaną rejestrację lub roszczenie; zachowaj ten sam profil.
access: blockedPrzestań nawet jeśli HTTP Odpowiedź na leczenie była 200. Przeglądaj konto lub połączenie w konsoli; nie traktuj odpowiedzi tożsamości jako zgody na zapytanie.
accountType: temporaryKorzystaj z próby kwalifikacyjnej w przypadku pracy jednorazowej. Zatwierdź to przed planowaniem; nowe połączenie OAuth nie powoduje powstania tego profilu.
installed: falsePo zatwierdzeniu właściciela, uruchom flashdata auth finish --wait z oryginalnym profilem i katalogiem stanu. Więc powtórz czek.
401 / invalid_grantPrzywrócenie wygasłego lub cofniętego kredytu w swoim oryginalnym gospodarzu. Nie rozpoczynaj kolejnego procesu, żeby go obejść.
403 / source_forbiddenSprawdź w kluczach lub w liście źródłowej OAuth. YouTube Download używa klucza właściciela API.
Ważny dostęp, zerowa równowagaUwierzytelnienie zadziałało. Zaznacz Billing przed płatną pracą; nie zastępuj poprawnego klucza.