Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Tích hợp

Tùy chọn xác thực tác nhân

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ốiDùngAi giữ thẻ tín dụng?
Một ứng dụng, SDK, CLI hay lịch làm việcSở hữu khóa APICử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ứuMCP OAuthMá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ảnPhím API tạm thờiTá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.

Nguồ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ệnCác nguồn sẵn sàng
Sở hữu khóa APICá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ờiChỉ đượ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 OAuthgoogle_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.

Nhập một lần
flashdata auth login --profile research

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.

Đặt phím · nhảy qua nếu đã cấu hình rồ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
Tài khoản đọc 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'
)

Đọ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 traCần kết quả
Tài khoản đã sửaaccountId 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ùngaccess: 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.

Trường nhận diện tạm thời
{
  "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.

Liệt kê máy phục vụ
codex mcp list

Kiể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.

Probe máy phục vụ
openclaw mcp doctor flashdata --probe

3. 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ệnCho nhiệm vụ tiếp theo
Sở hữu khóa APIDù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 OAuthNgườ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ờiHoà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.

Kiểm tra truy cập xử lý mới 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}'
)

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ốiNơi để thu hồi
MCP OAuthSettings → Connected apps Tiền trợ cấp của ứng dụng.
Tác nhân đã xác nhận API KhóaSettings → Connected apps Các mối liên hệ của tác nhân.
Phím APIAPI 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: blockedDừ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: temporaryDù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: falseSau 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_grantKế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_forbiddenKiể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ệ.