Duyệt tài liệu
Tích hợp
Kết nối với một API Khóa hay MCP OAuthđể xác minh quyền truy cập mà không cần yêu cầu trả tiền, và tái sử dụng nó cho các nhiệm vụ sau này.
Trên trang này
1. Chọn và kết nối
Đã kết nối rồi à? Đi thẳng đến kiểm tra miễn phí trong bước 2. Nếu không, hãy chọn truy cập vào đơn hoặc tác nhân của bạn cần.
| Bạn đang kết nối | Dùng | Ai giữ thẻ tín dụng? |
|---|---|---|
| Một ứng dụng, SDK, CLI hay lịch làm việc | Sở hữu khóa API | Cửa hàng bí mật của máy phục vụ của bạn hoặc CLI hồ sơ |
| Codex hay OpenClaw Công cụ nghiên cứu | MCP OAuth | Máy sau khi trình duyệt cho phép |
| Một tác nhân đang cố gắng. FlashData không có tài khoản | Phím API tạm thời | Tác nhân đã lưu hồ sơ thử nghiệm, sau đó chủ sở hữu truy cập sau khi tuyên bố |
Tạo một phím vào API Keys với các nguồn mà bạn cần, hoặc sử dụng lại một phím đã có. Cung cấp nó cho bạn SDK hoặc gửi nó như X-API-Key từ backend của anh. Hạt Bash và PowerShell kiểm tra trong bước 2 làm việc trực tiếp với các API; không CLI yêu cầu cài đặt.
Dùng máy đã cấu hình cho FlashData OAuth. Chủ tài khoản đã đăng ký hoặc đăng nhập và đồng ý trong trình duyệt; máy đó lưu các biểu tượng. Kết nối không được cài đặt CLI Chìa khóa hoặc đòi xét xử.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchĐối với một tác nhân không có chìa khóa, discover Phiên tòa xét xử hiện tại, trước khi đăng ký. Dùng lại một thử nghiệm và hồ sơ đã có. YouTube Download và việc lặp lại cần thiết quyền truy cập chủ sở hữu.
flashdata discover --profile research --jsonNguồn tin nào có thể được xác nhận này?
Dùng X-API-Key chuẩn HTTP yêu cầu và API-key MCP kết nối. OAuth Mang theo vật kỷ niệm chỉ làm việc ở chỗ chủ nhà MCP điểm cuối. YouTube Download Cần một chủ nhân API phím với youtube_download và lưu trữ địa điểm.
| Nhận diện | Các nguồn sẵn sàng |
|---|---|
| Sở hữu khóa API | Các nguồn được cấp cho chìa khóa, bao gồm youtube_download khi được chấp thuận. |
| Phím API tạm thời | Chỉ được cấp những nguồn có thể thử nghiệm. Đọc phạm vi từ phản ứng nhận dạng hiện thời. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Lưu một chìa khóa vào CLI
Bỏ qua mục nhập nếu bị tắt CLI Đã có quyền truy cập hoặc nguồn cung cấp cho người quản lý bí mật FLASHDATA_API_KEY. Nếu không, hãy chọn một phương pháp bên dưới và giữ hồ sơ nghiên cứu tương tự cho các lệnh sau. Được cứu CLI Khóa không tự động sẵn sàng cho SDKs hay cục bộ MCP Máy chủ.
Dán chìa khóa tại dấu nhắc thiết bị cuối bị ẩn.
flashdata auth login --profile researchĐặt FLASHDATA_KEY_FILE tới đường dẫn của một tập tin khóa đã được bảo vệ. Chỉ huy đọc nó qua stdin; giữ phím ra khỏi các đối số trò chuyện và lệnh.
: "${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. Kiểm tra kết nối
Chạy kiểm tra miễn phí trong môi trường sẽ thực hiện nhiệm vụ này. CLI và HTTP Kiểm tra dùng a API Chìa khóa; MCP Kiểm tra sử dụng kết nối đã lưu của máy.
Yêu cầu Bash và cURL 7.76+. Bỏ qua dấu nhắc phím bị ẩn nếu môi trường của bạn đã cung cấp FLASHDATA_API_KEY. Chạy lệnh đọc trong cùng một thiết bị cuối.
# 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'
)Bỏ qua dấu nhắc khoá bị ẩn nếu FLASHDATA_API_KEY đã được thiết lập. Chạy lệnh đọc trong cùng một thiết bị cuối.
# 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
}Sử dụng OS người dùng, hồ sơ và thư mục tiểu dụng từ việc đăng nhập. Thay thế nghiên cứu nếu bạn sử dụng hồ sơ khác; thêm --state-dir PATH nếu cần thiết. FLASHDATA_API_KEY Ghi đè phím đã lưu. Mong đợi ok: true và data.accessVerified: true; sau đó kiểm tra các lĩnh vực danh tính bên dưới.
flashdata auth status --profile research --json --non-interactiveGửi cái này cho một phiên họp mới của đại lý kết nối của anh. Thay thế google_search bằng nguồn mà bạn cần. Mong đợi cả hai công cụ đều thành công; kiểm tra từng bên giá trị và sự số dư trước khi được trả lương. Chỉ một máy phục vụ liệt kê không xác minh quyền truy cập.
Dùng kết nối Flashdata MCP đã có.
Gọi get_pricing với {"source":"google_search","request_count":1}.
Gọi get_balance với {}.
Báo cáo xem cả hai cuộc gọi có thành công không, liệu nguồn tin có giá cả không,
và số tiền tín dụng sẵn có. Một số không số dư không không phải là một thất bại xác thực.
Đừng chạy tìm kiếm hay tải về, tạo một thử nghiệm, hoặc thay đổi giấy ủy nhiệm.Đọc danh tính API-key
HTTP Các trường nhận dạng ở cấp độ cao nhất. Vào CLI JSONĐọc data.identity.identity và yêu cầu data.accessVerified: true. HTTP 200 hay CLI ok: true cô đơn là không đủ.
| Kiểm tra | Cần kết quả |
|---|---|
| Tài khoản đã sửa | accountId và apiKeyId nhận ra lời tường thuật và chìa khóa mà bạn định dùng. |
| Truy cập có thể dùng | access: ready |
| Cho phép tác vụ | Phạm vi chứa nguồn, như google_search. CLI cũng liệt kê các nguồn cho phép trong data.identity.permittedSources. |
| Đang đệ lại tác vụ | accountType: owned · installed: true · recurringAllowed: true |
Name
Một phiên tòa có thể vượt qua một lần kiểm tra nhiệm vụ trong khi recurringAllowed là false. Hãy đọc các phạm vi và lời giải phẫu đã có trước khi lên kế hoạch.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Tìm kết nối trong Codex
Liệt kê các máy phục vụ đã cấu hình, rồi dùng /mcp trong một cái mới Codex phiên họp. Kiểm tra MCP ở trên để xác minh xác nhận dấu vết.
codex mcp listKiểm tra kết nối OpenClaw
Probe máy phục vụ đã lưu, sau đó chạy các MCP kiểm tra trên đây trong cuộc nói chuyện tích cực của bạn.
openclaw mcp doctor flashdata --probe3. Dùng lại quyền truy cập các tác vụ sau
Giữ cửa hàng chứng nhận riêng và bền bỉ trong quá trình khởi động lại. Kiểm tra lại truy cập trong tiến trình mới trước khi bật trình lên lịch.
| Nhận diện | Cho nhiệm vụ tiếp theo |
|---|---|
| Sở hữu khóa API | Dùng lại chìa khóa đã lưu. Nó không có OAuth Bước cập nhật; thay thế nếu đã quá hạn hoặc bị thu hồi. |
| MCP OAuth | Người dẫn chương trình cập nhật một giờ. OAuth Bảng điều khiển truy cập bằng cách xoay bảng hiệu cập nhật. Tái kết nối khi 90- trợ cấp hàng ngày hết hạn hoặc bị thu hồi. Mỗi bản cài đặt sở hữu cửa hàng tượng trưng của nó; không chia sẻ các tập tin đã được cập nhật giữa các máy. |
| Phím API tạm thời | Hoàn tất liên kết với chủ tài khoản và bàn giao thông tin xác thực trước khi chạy tác vụ định kỳ. Dùng lại hồ sơ ban đầu; không đăng ký lại cho mỗi lần chạy. |
Kiểm tra một CLI tác vụ trước khi lên lịch
Yêu cầu Bash và jq. Đặt dấu hiệu của nhiệm vụ. Văn lệnh dùng việc nghiên cứu theo mặc định; thiết lập FLASHDATA_PROFILE và FLASHDATA_STATE_DIR cho một hồ sơ hay thư mục tiểu dụng khác. Thoát 0 có nhân dạng JSON có nghĩa là chìa khóa sở hữu đã sẵn sàng, được cài đặt và cho phép sử dụng nguồn này. Hãy cho lịch trình dừng lại ở bất kỳ lối ra nào khác. Không có truy vấn nào được gửi đi.
(
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}'
)Nếu truy cập vẫn còn là một phiên tòa
Hoàn thành hướng dẫn dùng thử và liên kết tài khoản bằng hồ sơ ban đầu. Sau khi chủ tài khoản phê duyệt và thông tin xác thực được bàn giao, phép kiểm tra miễn phí phải hiển thị quyền truy cập owned và recurringAllowed: true. Các yêu cầu tiếp theo dùng số dư chung của chủ tài khoản; tín dụng dùng thử chưa dùng không được chuyển sang. Đăng nhập MCP OAuth là kết nối riêng và không liên kết bản dùng thử này.
Thu hồi truy cập
Tạm dừng việc làm lại trước. Thu hồi lại các dấu chấm bên dưới, sau đó lặp lại việc kiểm tra miễn phí từ một tiến trình hoặc phiên chạy mới trước khi xóa bỏ truy cập địa phương. Mong đợi việc xác thực bị lỗi hoặc yêu cầu tái kết nối; không chấp nhận kết nối mới trong khi kiểm tra. Chỉ đăng xuất cục bộ thôi không thể thu hồi truy cập máy phục vụ.
| Kết nối | Nơi để thu hồi |
|---|---|
| MCP OAuth | Settings → Connected apps Tiền trợ cấp của ứng dụng. |
| Tác nhân đã xác nhận API Khóa | Settings → Connected apps Các mối liên hệ của tác nhân. |
| Phím API | API Keys chìa khóa được sử dụng bởi sự tích hợp này. |
Sửa một kiểm tra lỗi
| Kết quả | Hành động |
|---|---|
| accessVerified: false | Đọc giai đoạn và nextCommand. Name ok: true Trước khi chìa khóa được sử dụng. Hoàn tất giấy đăng ký lưu hoặc yêu cầu; giữ cùng hồ sơ. |
| access: blocked | Dừng lại ngay cả khi HTTP Trả lời là 200. Xem lại tài khoản hoặc kết nối trong bảng điều khiển; đừng xem phản ứng nhận diện là quyền truy vấn. |
| accountType: temporary | Dùng thử nghiệm thích hợp cho công việc một lần. Hãy khẳng định điều đó trước khi lên kế hoạch; một điều mới OAuth kết nối không đòi hỏi hồ sơ này. |
| installed: false | Sau khi được chủ sở hữu chấp thuận, chạy flashdata auth finish --wait với hồ sơ gốc và thư mục tiểu dụng. Vậy thì nhắc lại đi. |
| 401 / invalid_grant | Kết nối lại thời gian đã hết hạn hoặc bị thu hồi trong máy gốc của nó. Đừng bắt đầu một thử nghiệm khác để vượt qua nó. |
| 403 / source_forbidden | Kiểm tra phạm vi của khóa hoặc OAuth Danh sách nguồn. YouTube Download sử dụng chủ sở hữu API Chìa khóa. |
| Truy cập hợp lệ, số không số dư | Xác thực đã thành công. Kiểm tra Billing trước khi trả tiền, đừng thay thế một khóa hợp lệ. |