Duyệt tài liệu
Bắt đầu
Tạo khóa cho ứng dụng hoặc tác nhân. Lưu khóa, kiểm tra quyền truy cập và quản lý vòng đời của khóa.
Trên trang này
1. Tạo một phím
- Ký vào tài khoản đã kiểm tra và mở API Keys. Dùng lại chìa khóa có thẩm quyền nếu bạn đã có rồi.
- Hãy đặt tên cho ứng dụng và môi trường, chọn một bản expiry và chọn những nguồn cần thiết. Chọn Google Search cho ví dụ tìm kiếm đầu tiên.
- Tạo chìa khóa và lưu nó dưới đây. Cho các tác nhân độc lập và ứng dụng sản xuất riêng biệt để bạn có thể thu hồi chúng riêng lẻ.
2. Lưu phím
Hãy chọn con đường mà bạn sẽ đi. FlashData. API và SDK Ví dụ đọc FLASHDATA_API_KEY; các CLI có thể lưu lại chìa khóa trong hồ sơ được bảo vệ. Trong sản xuất, hãy tiêm giấy phép từ cửa hàng bí mật của anh.
# 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# 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 flashdataSecureKeyDán chìa khóa tại dấu nhắc ẩn. Đối với một hồ sơ tên, phụ --profile NAME ở đây và sau đó lệnh. Một hồ sơ đã cấu hình trước cần thiết đăng nhập --replace để thay thế chìa khóa.
flashdata auth login3. Truy cập kiểm tra
Chạy kiểm tra miễn phí trong cùng một thiết bị cuối hoặc hồ sơ CLI. Dùng thẻ tương ứng với cách bạn cất giữ khóa.
Dùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.
(
: "${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'
)Dùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.
& {
$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 khả năng truy cập CLI đã lưu. Đối với một hồ sơ tên, phụ --profile NAME cho mỗi lệnh. Những câu này không dùng các tài liệu truy vấn.
flashdata auth statusXác nhận tài khoản và nguồn
HTTP trả lại trực tiếp các trường này. Với CLI JSONTìm chúng ở dưới data.identity.identity và cũng yêu cầu data.accessVerified: true.
| Kiểm tra | Mong đợi |
|---|---|
| accountId | Tài khoản sở hữu số lượng công việc này. |
| access | ready |
| scopes | Bao gồm google_search cho lần tìm kiếm đầu tiên. |
| recurringAllowed | true trước khi chủ sở hữu lịch làm việc. |
Quyền hạn mã nguồn hoạt động như thế nào
Một chiếc chìa khóa chỉ có thể sử dụng những nguồn được ban cho. Sản phẩm được lựa chọn riêng biệt với giá cả: mỗi chìa khóa trong tài khoản tiêu dùng chung, bao gồm cả tín dụng được mua. Chìa khóa giới hạn không có nắp chi tiêu riêng. Những sản phẩm tương lai cần một khoản trợ cấp rõ ràng.
Nếu phím đã được phơi bày
- Thu hồi chìa khóa đã được phơi bày ngay lập tức trong trang điều khiển tương ứng bên dưới, và ngăn chặn những người gọi của nó theo lịch.
- Tạo một thay thế với các quyền hạn cần thiết, cài đặt nó trong mỗi cửa hàng bí mật của người gọi, và chạy kiểm tra miễn phí trên.
- ôn lại History và sử dụng tài khoản cho các hoạt động bất ngờ. Loại bỏ bí mật khỏi tập tin không thu hồi nó.
Xoay một phím
- Tạo một thay thế với các nguồn cần thiết và cài đặt nó vào môi trường đích.
- Lặp lại sự xác nhận miễn phí ở trên, rồi chuyển đổi chương trình ứng dụng hay lịch trình. Cập nhật mỗi cuộc gọi có chủ đích.
- Thu hồi lại chìa khóa cũ sau khi người gọi đã đổi. Một tin cập nhật bí mật về laptop của bạn không cập nhật dịch vụ triển khai.
flashdata auth login --replace
flashdata auth statusThu hồi truy cập
Dừng cuộc gọi, thu hồi các phím hoặc kết nối khớp dưới đây, sau đó lặp lại việc xác thực miễn phí với các khe hở cũ. Nên từ chối. Đăng nhập vào địa phương không thu hồi truy cập máy phục vụ.
| Kiểu truy cập | Nơi để thu hồi |
|---|---|
| Phím API bình thường | API Keys |
| Đã xác nhận phím tác nhân | Settings → Connected apps → Agent connections |
| MCP OAuth Cung cấp | Settings → Connected apps |