Xác thực & Quản lý API Key

Hệ thống StackVid hỗ trợ hai hình thức xác thực an toàn, phù hợp cho cả ứng dụng web tương tác lẫn các script tự động hóa ngầm.

---

1. Xác thực bằng API Key (Khuyên dùng cho Backend & Script)

API Key là phương thức lý tưởng cho các tác vụ server-to-server, lệnh cronjob, webhook hay các workflow n8n.

Định dạng API Key

• Mọi API Key đều bắt đầu bằng tiền tố: tk_live_...
• Phía cơ sở dữ liệu chỉ lưu trữ chuỗi băm mật mã học (SHA-256), máy chủ không thể đọc ngược lại khóa gốc của bạn.

Cách gửi API Key trong Request

Truyền API Key vào HTTP Header X-API-Key:

cURL

curl -X GET https://api.stackvid.dev/api/users/me \
  -H "X-API-Key: tk_live_9f8e7d6c5b4a3..."

Node.js (Axios)

import axios from 'axios';

const api = axios.create({
  baseURL: 'https://api.stackvid.dev/api',
  headers: {
    'X-API-Key': process.env.STACKVID_API_KEY,
  },
});

Python (Requests)

import os
import requests

headers = {
    'X-API-Key': os.getenv('STACKVID_API_KEY')
}
res = requests.get('https://api.stackvid.dev/api/users/me', headers=headers)

---

2. Xác thực bằng Bearer JWT Token (Dành cho Web App / SPA)

Khi đăng nhập qua giao diện người dùng, hệ thống trả về một mã accessToken (JSON Web Token) có thời hạn hiệu lực.

Cách sử dụng JWT:

Truyền token vào Header Authorization theo chuẩn Bearer:

Authorization: Bearer eyJhbG...9...

---

3. Quản lý API Key trên Dashboard

Bạn có thể dễ dàng tạo mới, sao chép và thu hồi các API Key trực tiếp trên giao diện Dashboard → API Keys (/api-keys):

• Tạo mới: Nhập tên gợi nhớ (ví dụ: Production Server hoặc n8n Worker) và bấm Tạo khóa. Lưu ý sao chép chuỗi khóa bí mật ngay vì hệ thống chỉ hiển thị đầy đủ một lần duy nhất nhằm bảo đảm an toàn.
• Thu hồi: Bấm nút Thu hồi bên cạnh khóa tương ứng để vô hiệu hóa ngay lập tức khi không còn sử dụng hoặc nghi ngờ bị lộ.
• Mọi khóa đã thu hồi sẽ bị từ chối truy cập ngay lập tức với mã lỗi 401 Unauthorized.