Xác thực GenderAPI – API key và Bearer token

Tổng quan xác thực

Chọn cách gửi API key

Mọi yêu cầu cần xác thực đều phải có GenderAPI key hợp lệ. Authorization header là phương thức mặc định được khuyến nghị vì tách thông tin xác thực khỏi dữ liệu yêu cầu.

Bearer token

Gửi key trong Authorization header.

Phần thân JSON

Gửi key như một trường POST phía máy chủ.

Khuyến nghị

Authorization header

Bearer token

Đặt Authorization: Bearer YOUR_API_KEY và chỉ gửi các tham số đầu vào trong phần thân JSON.

AuthorizationBearer YOUR_API_KEY

cURL

curl -X POST "https://api.genderapi.io/api" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"name":"Alice"}'

JavaScript

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({ name: "Alice" })
});

Phương án khác

API key trong phần thân JSON

Phần thân POST

Đưa key vào thuộc tính key cùng dữ liệu yêu cầu. Chỉ dùng phương thức này trong mã phía máy chủ đáng tin cậy.

cURL

curl -X POST "https://api.genderapi.io/api" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","key":"YOUR_API_KEY"}'

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api",
  json={
    "name": "Alice",
    "key": "YOUR_API_KEY"
  }
)
print(response.json())

An toàn thông tin xác thực

Bảo vệ API key

Lưu key trong biến môi trường phía máy chủ hoặc trình quản lý secret.
Không commit key vào source control hoặc để lộ trong JavaScript trình duyệt.
Loại bỏ thông tin xác thực khỏi log ứng dụng, proxy và analytics.
Dùng HTTPS cho mọi yêu cầu và thay key nếu có khả năng đã bị lộ.

So sánh nhanh

Nên dùng phương thức nào?

Phương thức	Phù hợp nhất	Vị trí thông tin xác thực
Bearer tokenKhuyến nghị	Hầu hết tích hợp phía máy chủ	`Authorization` header
Phần thân JSON	Tích hợp POST hiện có	Thuộc tính `key`

Content type của POST: đặt Content-Type: application/json khi gửi phần thân yêu cầu JSON.

Hướng dẫn tiếp theo

Gửi yêu cầu một tên

Giới tính từ tênTham số và phản hồi cho yêu cầu đơn →Thư viện clientQuay lại SDK chính thức →