# Đầu trang và xác thực

Dùng đúng máy chủ và thông tin xác thực, rồi kiểm tra quyền truy cập bằng một yêu cầu miễn phí.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/headers-and-authentication
Xem lại: 2026-11-04 by FlashData

<a id="requests"></a>

## Cơ sở URLs

| Mục đích | Cơ sở URL | Xác thực |
| --- | --- | --- |
| Công việc và yêu cầu dữ liệu | https://data.flashdata.dev/v1 | X-API-Key |
| Nhận dạng, số dư, giá trị, giới hạn và sử dụng | https://api.flashdata.dev/v2 | X-API-Key |
| MCP từ xa | https://data.flashdata.dev/mcp | Quản lý máy OAuth, hoặc X-API-Key |


<a id="choose"></a>

## Đầu trang xác thực

Yêu cầu REST sử dụng X-API-Key với một chìa khóa thử hay chủ sở hữu. Gởi JSON Xác với Content-Type: application/json. CLI hồ sơ, SDK môi trường và MCP kết nối ủy nhiệm cửa hàng riêng biệt.

### TIẾNG TÂM / API Khóa

#### Yêu cầu người dẫn đầu

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

Hãy để cho... MCP máy giành được, lưu và nạp lại hiệu ứng này qua đăng nhập. Chỉ sử dụng nó tại MCP điểm cuối. Máy dùng một API Name X-API-Key.

#### Đầu trang được quản lý bởi máy MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Lấy khóa API](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md)
- [Kết nối MCP](https://flashdata.dev/vi/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## Kiểm tra chìa khóa của bạn

Cho chạy cái này ở trạm cuối. Kiểm tra danh tính mà không dùng tín dụng. Bỏ qua dấu nhắc phím nếu FLASHDATA_API_KEY đã được thiết lập.

### Bash / cURL

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
# 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

```bash
(
: "${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'
)
```


### PowerShell 7

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.

#### Đặt phím · nhảy qua nếu đã cấu hình rồi

```powershell
# 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
```

#### Tài khoản đọc JSON

```powershell
& {
  $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
}
```



<a id="result"></a>

### Mong đợi câu trả lời

Mong đợi HTTP 200. Kiểm tra tài khoản đã định, access: ready và nguồn cung cấp của anh trong phạm vi. Một phím tạm thời có accountType: temporary; lặp lại công việc của chủ sở hữu yêu cầu recurringAllowed: true.

#### Đoạn trả lời minh họa cho người sở hữu

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [Thực hiện lệnh gọi API đầu tiên](https://flashdata.dev/vi/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## Được ký vào kho URLs

Kết quả và tải lên URLs bao gồm cả quyền của họ. Đi theo người trở về. URL không có X-API-Key, OAuth các thẻ hay cookie trình duyệt.


<a id="errors"></a>

## Name

| Phản hồi | Bước tiếp theo |
| --- | --- |
| 401 | Kiểm tra chìa khóa trong môi trường này, sự giải thoát và sự tái tạo. Dùng hiện tại API không phải là... MCP hay tiền tố của Bearer. |
| 403 / mã nguồn còn thiếu | Yêu cầu chủ sở hữu cung cấp nguồn cần thiết cho chiếc chìa khóa này. |
| 503 trên này đọc tự do | Hãy thử đọc lại sau. Chưa xác nhận tình trạng tài khoản; đừng cho rằng một yêu cầu được trả tiền đã sẵn sàng. |

