Duyệt tài liệu
Bắt đầu
Kiểm tra truy cập, sửa yêu cầu không thành công hoặc tìm câu trả lời về cách sử dụng FlashData.
Trên trang này
Bắt đầu với việc kiểm tra truy cập miễn phí
Chạy kiểm tra xem tác vụ bị lỗi ở đâu. Dùng thẻ đã có; những lệnh này không đệ trình truy vấn.
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 --version
flashdata doctor --offline
flashdata auth status --jsonDùng tác vụ đã có FLASHDATA_API_KEY trong cùng một nhà ga, container hoặc công việc đã được sắp xếp. Yêu cầu cURL 7.76+.
(
: "${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 tác vụ đã có FLASHDATA_API_KEY trong cùng một nhà ga, container hoặc công việc đã được sắp xếp.
& {
$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
}Kiểm tra cái gì?
Nhân dạng thì phải có chứ access: ready và bao gồm cả nguồn của anh trong phạm vi. Vào CLI JSONDanh tính là data.identity.identity; cũng cần thiết data.accessVerified: true. Một lệnh thành công với accessVerified: false chưa xác nhận truy cập.
Cho một người tên là CLI hồ sơ, phụ lục --profile NAME cho mỗi lệnh bên dưới. Giữ nguyên bản gốc --state-dir và OS người dùng. FLASHDATA_API_KEY Ghi đè một tập tin đã lưu CLI Chìa khóa; SDK và MCP Các chủ thể sử dụng cấu hình biểu tượng của riêng họ.
Tìm kiếm và sửa chữa vấn đề
Mở triệu chứng khớp với lỗi của anh. Sử dụng IDs và biên nhận từ nhiệm vụ gốc.
Không tìm thấy lệnh hay hồ sơ nào thiếu
Không có tập tin thực hiện được: hãy cài đặt cách giải thoát cho bạn. OS/CPU và thêm thư mục vào PATH. Thiếu hồ sơ: Dùng tên gốc OS người dùng và thư mục tình trạng. Kiểm tra bên trong lịch hay container nữa.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: khóa, phạm vi hoặc tiền sử
Để thay thế một phím đã lưu, hãy dán phím đã chấp nhận vào dấu nhắc ẩn. Nếu FLASHDATA_API_KEY là thiết lập, cập nhật lại bí mật đó trong thời gian chạy; để dành một bí mật khác CLI Chìa khóa sẽ không đè lên nó.
- 401: kiểm tra xem một khóa đã hết hạn, bị thu hồi hoặc đã cấu hình sai. 403: so sánh mã nguồn đã yêu cầu với phạm vi nhận dạng.
- Name X-API-Key. An MCP OAuth không thể thay thế dấu hiệu API Chìa khóa. Để truy cập tạm thời, hãy sử dụng việc thu hồi bên dưới.
flashdata auth login --replace
flashdata auth status --jsonXác nhận được chấp thuận, nhưng tác nhân vẫn có quyền ra tòa.
Kết thúc bàn tay trong cùng một CLI hồ sơ đã tạo ra yêu cầu. Người chủ đã đăng nhập xong, kiểm tra email và đồng ý trong trình duyệt; CLI Nhận được giấy chứng nhận.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonYêu cầu một liên kết mới cho phiên tòa hiện có, hãy để cho người chủ chấp thuận, sau đó chạy auth finish. Đừng chạy init nữa.
flashdata auth claim402: không đủ thẻ
So sánh availableCredits với giá hiện tại cho nguồn của bạn. Xác nhận một phiên tòa đã hết hạn để sử dụng số dư của chủ nhân, hoặc để cho chủ nhân xem xét lại Billing trước khi thử lại.
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 account balance
flashdata account pricing --source google_search --request-count 1Dùng tác vụ đã có FLASHDATA_API_KEY trong cùng một nhà ga, container hoặc công việc đã được sắp xếp. Yêu cầu cURL 7.76+.
(
: "${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/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)Dùng tác vụ đã có FLASHDATA_API_KEY trong cùng một nhà ga, container hoặc công việc đã được sắp xếp.
& {
$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/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: đợi trước khi thử lại
Đọc Retry-After khi phản ứng không thành công: giây hoặc a HTTP hẹn hò. Hãy chờ tới lúc đó và giảm bớt sự đồng thuận. Giấy đăng ký phiên tòa cho phép 3 đăng ký mỗi IP 24- tiếng cửa sổ; dùng lại hồ sơ gốc và chứng minh đăng ký.
Việc đọc miễn phí này cho thấy việc tiết kiệm đầu đề, địa vị và cơ thể. Sử dụng Retry-After từ các thao tác thất bại; truy vấn, đăng ký và giới hạn đọc tài khoản có thể khác nhau.
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400 / 422: lỗi nhập hay xử lý bị từ chối
Đọc mã, chi tiết và fieldErrors từ HTTP Lỗi. Sửa chữa thi thể yêu cầu, lưu nó như request.jsonsau đó xác nhận nó. Lưu thông tin về kho lưu vào tập tin nhập liệu cá nhân. Nếu 422 đến từ một kết quả công việc đã có, thanh tra job.error Đầu tiên.
flashdata query --input request.json --mode async --dry-run --jsonCông việc đang chờ, hay HTTP 200 với một công việc thất bại
Đọc công việc từ submission.jsonHóa đơn của anh đã được lưu giữ. HTTP 200 có nghĩa là tình trạng đọc thành công; job.status là kết quả công việc (data.status in CLI JSON). Vì BatchLưu mục thích hợp từ các yêu cầu như submission.json.
| Trạng thái hay lỗi | Hành động tiếp theo |
|---|---|
| pending / processing | Hãy chờ cho đến cùng một công việc, đừng bao giờ đệ đơn nữa. |
| completed | Tìm và cứu lấy kết quả đã có. |
| failed | Kiểm tra job.error trước khi gửi công việc sửa chữa. |
| 404 | Kiểm tra công việc ID và bản báo cáo gửi tới. |
| 409 | Kết quả chưa sẵn sàng. Cứ tiếp tục bỏ phiếu cho cùng một công việc. |
| 410 | Đã lưu JSON hết hạn sau 24 giờ. Sử dụng bản sao lưu của bạn; truyền thông giao hàng có lưu trữ của riêng mình. |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)Thời hạn / 5x: Công việc được chấp nhận không?
Kiểm tra chạy đầu tiên và History trước khi thử lại a POST. Phục hồi một công việc đã được xác nhận. Nếu không được chấp nhận, cứ chạy. ID và hỗ trợ liên lạc; thay đổi IDs và phục tùng có thể tái bản cáo trạng.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: tập tin kết quả đã có
CLI không ghi đè lên tập tin --output. Đọc tập tin đã có, hoặc chọn tên tập tin xuất mới trong khi giữ tên gốc --run-id và yêu cầu. Không được tạo ra một cuộc chạy đua mới. ID để bỏ qua lỗi này.
flashdata runs show RUN_IDTìm kiếm rỗng, thiếu chú thích hoặc tải về không đọc được
Những lệnh này chỉ đọc tập tin kết quả cục cục bộ, không phải các CLICủa stdout phong bì.
Nếu tình trạng được thực hiện và hữu cơ trống, hãy nới lỏng bộ lọc truy vấn. Hãy giữ cho kết quả trống rỗng trong hồ sơ công việc của bạn.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonSiêu dữ liệu liệt kê mã ngôn ngữ, không phải theo dõi bằng tay hay tự động. Chọn một ngôn ngữ được liệt kê và đặt tự động explicitly: true cho tự động, false hướng tới hướng dẫn sử dụng. Không có dấu vết khớp nghĩa là không có chú thích cho việc chọn; FlashData không tạo ra một thay thế.
jq '.results[0].transcriptLanguages' metadata.jsonĐọc xong delivery.json Hóa đơn. Tải về các đối tượng với xác thực về đích của bạn, sau đó so sánh kích cỡ của nó và MD5 với hóa đơn. Riêng tư file_url không được công khai sau khi giao hàng.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP Các công cụ bị thiếu hoặc xác thực hết hạn
Kiểm tra máy đang chạy nhiệm vụ. Máy phục vụ đã liệt kê xác nhận cấu hình, không phải kết nối làm việc. Nếu máy đã cấu hình OAuth kết nối cần thiết đăng nhập, chạy lệnh đăng nhập và chấp thuận hoàn toàn trình duyệt, rồi thay đổi danh sách công cụ.
Mở /mcp trong Codex CLI để kiểm tra tình trạng và công cụ kết nối. Trong ứng dụng, kiểm tra máy phục vụ đã cấu hình và khởi động một phiên chạy mới sau khi thiết lập thay đổi.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth Đăng nhập không sửa chữa một API- Kết nối chìa khóa. Kiểm tra chìa khóa trong môi trường của nền tảng và quyền hạn nguồn của nó. Đối với stdio địa phương, kiểm tra các MCP gói Node.js yêu cầu và khởi động lại máy sau khi cập nhật môi trường.
node --versionKĩ năng được cài đặt nhưng tác nhân không thể tìm hay sử dụng nó
Kiểm tra cùng một dự án, hồ sơ máy chủ và cài đặt vị trí, sau đó bắt đầu một phiên họp tác nhân mới. CLI Kỹ năng công việc cần thiết CLI; flashdata-mcp cần một kết nối MCP máy chủ. Cài đặt một kỹ năng không kết nối đến máy phục vụ hay cho phép tài khoản.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkThường xuyên đặt câu hỏi
Đang kết nối
Tôi có cần tác nhân AI không?
Không. Sử dụng HTTP API, Go/Python/TypeScript SDK, CLI hoặc điều khiển trực tiếp. MCP và kỹ năng là những lựa chọn bổ sung cho các tác nhân.
Tôi nên chọn giao diện nào?
Dùng a SDK hay HTTP API bên trong một ứng dụng, CLI cho tác vụ thiết bị cuối, và MCP cho một MCP- Máy chủ có khả năng. Kĩ năng cung cấp hướng dẫn cho cả hai CLI tác vụ hay kết nối MCP công cụ; chúng không thay thế xác thực.
Tôi có thể tái sử dụng giấy ủy quyền cho các nhiệm vụ lặp lại không?
Phải. Dùng quyền người sở hữu và bảo vệ cùng một bảo vệ CLI hồ sơ, mật thời gian chạy hoặc MCP kết nối. Vì API- Khóa truy cập, kiểm tra recurringAllowed: true. Chủ nhà hoặc người lập lịch làm việc.
Việc xóa các thiết lập cục bộ có hủy bỏ truy cập không?
Không. Thu hồi API Chìa khóa hoặc kết nối trong bàn điều khiển. Đang xóa các thiết lập cục bộ chỉ gỡ bỏ bản sao chép cục bộ đó.
Thử thách và tín dụng
Có thể có một đại diện cố gắng FlashData Trước khi đăng ký?
Vâng, với quyền truy cập tạm thời qua CLI hay lên tàu API. Hãy dùng lại hồ sơ và chứng minh đăng ký. Tiếp tục sử dụng nhu cầu đòi hỏi xác nhận hoặc một chủ sở hữu có API Chìa khóa.
Việc tuyên bố có thêm một khoản trợ cấp xét xử khác không?
Tự khẳng định không cho phép thử nghiệm thêm. Yêu cầu tương lai sử dụng số dư tài khoản của chủ sở hữu; tín dụng tạm thời không chuyển đổi. Một tài khoản mới được tạo theo chính sách đăng nhập thông thường.
Tôi có thể trả bao nhiêu yêu cầu?
Kiểm tra số dư tài khoản và giá cả nguồn. Yêu cầu phụ thuộc vào nguồn, và nhiệm vụ mã nguồn lẫn nhau chia sẻ một sự số dư. YouTube Download giá trị được tải xuống bằng byte, chứ không phải số lần yêu cầu cố định.
Nguồn và kết quả
Tại sao tác nhân của tôi có thể tìm kiếm mà không tải xuống?
Tải về cần phải có quyền sở hữu, youtube_download Cho phép và lưu trữ điểm đến. Thử ra tạm thời và mcp:research OAuth không bao gồm việc tải về. Một chủ sở hữu có thẩm quyền API Chìa khóa có thể sử dụng nó thông qua CLI, HTTP hay MCP.
Google Search có trở lại đầy trang web không?
Nó trả lại kết quả tìm kiếm và trích đoạn. Ứng dụng hay tác nhân của bạn đọc các điều được chọn URLs.
Có FlashData Tạo bản tóm tắt video hay tiêu đề?
Nó thu thập siêu dữ liệu và phụ đề đã có. Nó không tạo ra phụ đề thiếu; mô hình của bạn viết tóm tắt từ kết quả sẵn có.
Vẫn kẹt à? Gửi báo cáo tối thiểu
Cứu lấy HTTP Lỗi xác hoặc CLI JSON lỗi từ stderr dạng diagnostic.json. Trích dẫn bộ nhận diện chỉ sau khi lệnh bị lỗi. Giữ phím, yêu cầu mật và ký URLs ra khỏi báo cáo. Vì không phải...JSON trả lời, báo cáo HTTP Trạng thái từ diagnostic-status.txt.
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonThời gian UTC:
Khách & phiên bản:
Nguồn + giai đoạn (tự động / nộp / bỏ phiếu / lấy):
HTTP Trạng thái + mã lỗi:
Yêu cầu ID / Công việc ID / Chạy ID:
Nhận / không biết kết quả: chấp nhận / không rõ
Mong đợi kết quả thực tế chống lại kết quả: