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

Bắt đầu

Câu hỏi thường gặp và khắc phục sự cố

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.

Tài khoản miễn phí đọc
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Xác định tập tin thực hiện được
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 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ó.

  1. 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.
  2. 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.
Thay thế và xác minh một phím đã lưu
flashdata auth login --replace
flashdata auth status --json

Xá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.

Kết thúc và xác minh
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: 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.

Tài khoản miễn phí đọc
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Nhận được câu trả lời . Bash / cURL / jq
# 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
)
Kiểm tra khả năng tài khoản
flashdata account limits

400 / 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.

Kiểm tra mà không được trả lương
flashdata query --input request.json --mode async --dry-run --json

Cô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ỗiHành động tiếp theo
pending / processingHãy chờ cho đến cùng một công việc, đừng bao giờ đệ đơn nữa.
completedTìm và cứu lấy kết quả đã có.
failedKiểm tra job.error trước khi gửi công việc sửa chữa.
404Kiểm tra công việc ID và bản báo cáo gửi tới.
409Kế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.
Kiểm tra công việc đã lưu : Bash / jq
# 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
)
Vẫn đang chạy, dùng cái đã gửi về JOB_ID
flashdata jobs wait JOB_ID
Hoàn tất * Dùng tên tập tin xuất mới
flashdata jobs result JOB_ID --output recovered-result.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.

Kiểm tra trước · replace RUN_ID
flashdata runs show RUN_ID
Đã nhận việc làm
flashdata runs recover RUN_ID

CLI 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.

Kiểm tra chạy gốc
flashdata runs show RUN_ID

Tì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ì.

MCP 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.

Kiểm tra cấu hình
codex mcp list
Chỉ khi OAuth Cần thiết đăng nhập
codex mcp login flashdata --scopes mcp:research

Kĩ 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.

Kiểm tra giá trị mặc định CLI Kĩ năng gói gọn
flashdata skills verify --agent codex

Thườ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.

Bắt lấy một kẻ tự do. CLI Kiểm tra truy cập l· Bash
flashdata auth status --json 2> diagnostic.json
Name Bash / jq
# 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.json
Hỗ trợ báo cáo
Thờ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ả: