# Xác thực

> URL: https://foura.ai/vi/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

Mọi request đến FourA API đều yêu cầu xác thực. Trang này giải thích cách lấy, sử dụng và quản lý API key của bạn.

## Lấy API key của bạn

1. Đăng nhập vào [FourA Dashboard](https://foura.ai/dashboard)
2. Đi tới trang **API Keys**
3. Nhấp vào **Create Key**
4. Sao chép key từ hộp thoại xác nhận

API key của bạn có dạng như sau: `pk_live_a1b2c3d4e5f6...`

Các key được tạo hôm nay có thể hiển thị lại: nhấp vào biểu tượng con mắt trên hàng của key sau này để hiển thị lại toàn bộ secret theo nhu cầu (xem [Quản lý API Key](https://foura.ai/docs/dashboard/api-keys) để biết quy trình hiển thị và quyền hạn). Các key cũ được tạo trước khi tính năng hiển thị được phát hành không thể hiển thị lại và sẽ có biểu tượng ổ khóa; hãy tạo lại một lần để chuyển đổi.

## Sử dụng API key của bạn

Bao gồm API key của bạn trong header `X-API-Key` của mỗi request:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

Trong Python:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

Trong Node.js:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## Bảo mật API Key

Hãy bảo vệ API key của bạn như mật khẩu:

- **Không commit key vào hệ thống quản lý phiên bản.** Hãy dùng biến môi trường.
- **Không để lộ key trong mã nguồn client-side.** Chỉ sử dụng key trong các ứng dụng server-side.
- **Xoay vòng key nếu bị lộ.** Tạo lại key từ Dashboard. Khóa bí mật cũ sẽ ngừng hoạt động trong vòng một phút, và mỗi lần xem key đều được ghi nhật ký kiểm toán (audit log) để dễ dàng phát hiện thông tin xác thực bị đánh cắp sau đó.

### Sử dụng biến môi trường

Lưu trữ key của bạn trong biến môi trường:

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

Sau đó tham chiếu giá trị này trong mã của bạn:

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## Các lỗi xác thực thường gặp

Mọi lỗi xác thực đều trả về trạng thái `401 Unauthorized`.

| Lỗi | Thông báo | Nguyên nhân | Cách khắc phục |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | Không có header `X-API-Key` trong request | Thêm header `X-API-Key` |
| 401 | Invalid API key | Sai key, thừa khoảng trắng, hoặc key đã bị vô hiệu hóa | Xác minh lại key, xóa khoảng trắng, hoặc tạo key mới từ Dashboard |

Nếu FourA tạm thời không thể kiểm tra key, ví dụ trong khi cơ sở dữ liệu chuyển đổi dự phòng, hệ thống sẽ trả về `503` kèm `API key check temporarily unavailable` và `Retry-After: 5`, không bao giờ trả về `401`. Hãy thử lại sau thời gian chờ đó: key của bạn hoàn toàn hợp lệ.

Mọi response, dù thành công hay thất bại, đều chứa header `X-Foura-Request-Id`, ngoại trừ phần body mà FourA hoàn toàn không đọc được (JSON sai định dạng, hoặc body vượt quá 100 KB), trường hợp này sẽ bị từ chối trước khi ID được tạo. Hãy ghi log giá trị này ở phía bạn để bộ phận hỗ trợ có thể tra cứu lệnh gọi cụ thể sau này.

## Các bước tiếp theo

- [Quick Start](https://foura.ai/docs/getting-started/quick-start): Thực hiện request đầu tiên của bạn
- [Quản lý API Key](https://foura.ai/docs/dashboard/api-keys): Hiển thị, chỉnh sửa, tạo lại và xóa key
- [API Endpoints](https://foura.ai/docs/api/endpoints): Tài liệu tham khảo endpoint đầy đủ
- [Xử lý lỗi](https://foura.ai/docs/api/errors): Xử lý các lỗi xác thực một cách tối ưu
