Xác Thực

Tất cả các yêu cầu API đến GenderAPI đều cần xác thực. Bạn có thể xác thực yêu cầu của mình bằng hai cách:

1. API Key trong phần body của POST dưới dạng tham số key
2. API Key trong header Authorization sử dụng Bearer token

1. API Key trong Body của POST

Cách đơn giản nhất để xác thực là bao gồm API key của bạn trong phần body JSON của yêu cầu POST, với trường tên là key.

Ví dụ, để xác định giới tính của tên "Alice":

Ví dụ với cURL

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

Ví dụ với JavaScript fetch

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Alice",
    key: "YOUR_API_KEY"
  })
})
.then(response => response.json())
.then(data => console.log(data));

Ví dụ với Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "key": "YOUR_API_KEY"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

2. API Key trong Header Authorization (Bearer Token)

Để bảo mật tốt hơn và giúp yêu cầu gọn gàng hơn, bạn có thể gửi API key của mình trong header Authorization sử dụng cơ chế Bearer. Với cách này, bạn không cần đưa API key vào phần body JSON.

Thay vào đó, chỉ các tham số đầu vào của bạn (như name) được đặt trong body của POST.

Ví dụ, để xác định giới tính của tên "Alice":

Ví dụ với cURL

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

Ví dụ với JavaScript fetch

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

Ví dụ với Python requests

import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Chọn Giữa Hai Phương Thức

Cả hai phương thức xác thực đều được hỗ trợ trên tất cả các endpoint của API. Tuy nhiên, sử dụng header Authorization sẽ bảo mật hơn vì nó giữ API key của bạn tránh khỏi phần body của request và hạn chế việc vô tình ghi log nó ra.

Dù sử dụng phương thức nào, luôn đặt header Content-Type thành application/json khi gửi yêu cầu POST.