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
  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 để 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:

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:

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:

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:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

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

import os
api_key = os.environ["FOURA_API_KEY"]
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

Cập nhật: 29 tháng 10, 2026