Przeglądaj dokumentację
Integracje
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ę | Stosowanie | Kto trzyma wiarygodność? |
|---|---|---|
| Aplikacja, SDK, CLI lub zaplanowany skrypt | Właściciel klucz API | Sklep tajny serwera lub profil CLI |
| Narzędzia badawcze Codex lub OpenClaw | MCP OAuth | Host po uzyskaniu zgody przeglądarki |
| Agent próbujący użyć FlashData bez konta | Tymczasowy klucz API | Agent 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.
Użyj hosta skonfigurowanego dla FlashData OAuth. Właściciel konta kończy podpisywanie lub podpisywanie i wyraża zgodę w przeglądarce; host zapisuje żetony. To połączenie nie instaluje klucza CLI ani nie rości sobie procesu.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchDla agenta bez klucza discover aktualna kwalifikacja próbna przed rejestracją. Ponownie użyj istniejącego procesu i jego profilu. YouTube Download i powtarzające się zadania wymagają dostępu właściciela.
flashdata discover --profile research --jsonZ 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.
| Kredytowe | Dostępne źródła |
|---|---|
| Właściciel klucz API | Źródła przyznane kluczykowi, w tym youtube_download po zatwierdzeniu. |
| Tymczasowy klucz API | Wyłącznie przyznane źródła kwalifikowane do badania. Odczytywanie sopów z bieżącej odpowiedzi tożsamości. |
| MCP OAuth | google_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.
flashdata auth login --profile researchUstaw FLASHDATA_KEY_FILE na ścieżkę istniejącego pliku kluczy chronionych. Polecenie odczytuje go poprzez stdin; nie wpuszczaj klawisza do argumentów czatu i poleceń.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"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.
# 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(
: "${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'
)Pomiń ukryty sygnał klawisza, jeśli FLASHDATA_API_KEY jest już ustawiony. Uruchom polecenia odczytu w tym samym terminalu.
# 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& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Użyj katalogu użytkownika, profilu i stanu OS z logowania. Zastąp badania, jeśli używasz innego profilu; w razie potrzeby dodaj --state-dir PATH. FLASHDATA_API_KEY nadjeżdża zapisany klucz. Oczekuj ok: true i data.accessVerified: true; następnie sprawdź pola identyfikacyjne poniżej.
flashdata auth status --profile research --json --non-interactiveWyślij to na nową sesję swojego powiązanego agenta. Zastąp google_search źródłem, którego potrzebujesz. Oczekuj, że oba narzędzia wywołają sukces; sprawdź cenę i równowagę oddzielnie przed płatną pracą. Sam serwer nie weryfikuje dostępu.
Użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_pricing z {"source":"google_search","request_count":1}.
Zadzwoń do get_balance z {}.
Proszę podać, czy oba połączenia zakończyły się sukcesem, czy źródło ma dostępną cenę,
oraz dostępne saldo kredytowe. Saldo zerowe nie jest wadą uwierzytelniania.
Nie uruchamiaj wyszukiwania ani pobierania, nie twórz prób ani nie zmieniaj referencji.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 konto | accountId i apiKeyId identyfikują konto i klucz, którego chcesz użyć. |
| Dostęp możliwy do użycia | access: ready |
| Zezwolenie na zadanie | Szopy zawierają źródło, takie jak google_search. CLI zawiera również listę dozwolonych źródeł w data.identity.permittedSources. |
| Powtarzające się zadanie | accountType: 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.
{
"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ść.
codex mcp listSprawdź połączenie w OpenClaw
Sprawdź zapisany serwer, a następnie uruchom kontrolę MCP powyżej w aktywnej rozmowie.
openclaw mcp doctor flashdata --probe3. 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.
| Kredytowe | Do następnego zadania |
|---|---|
| Właściciel klucz API | Ponownie 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 OAuth | Host 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 API | Wykoń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.
(
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łączenie | Gdzie należy odwołać |
|---|---|
| MCP OAuth | Settings → Connected apps → grant aplikacji. |
| Zatwierdzony agent API klucz | Settings → Connected apps → Połączenia agentów. |
| Konto API klucz | API Keys → klucz używany przez tę integrację. |
Napraw nieudany sprawdzian
| Wynik | Działanie |
|---|---|
| accessVerified: false | Faza 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: blocked | Przestań 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: temporary | Korzystaj z próby kwalifikacyjnej w przypadku pracy jednorazowej. Zatwierdź to przed planowaniem; nowe połączenie OAuth nie powoduje powstania tego profilu. |
| installed: false | Po zatwierdzeniu właściciela, uruchom flashdata auth finish --wait z oryginalnym profilem i katalogiem stanu. Więc powtórz czek. |
| 401 / invalid_grant | Przywrócenie wygasłego lub cofniętego kredytu w swoim oryginalnym gospodarzu. Nie rozpoczynaj kolejnego procesu, żeby go obejść. |
| 403 / source_forbidden | Sprawdź 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ównowaga | Uwierzytelnienie zadziałało. Zaznacz Billing przed płatną pracą; nie zastępuj poprawnego klucza. |