API güvenliği

Gender API sorgularını doğrulayın

Özel API anahtarınızı Bearer token olarak gönderin veya sunucu tarafındaki JSON sorgu gövdesine ekleyin.

HTTPS zorunluDesteklenen iki yöntem

Kimlik doğrulama özeti

API anahtarınızı nasıl göndereceğinizi seçin

Kimlik doğrulanan bütün sorgular geçerli bir GenderAPI anahtarı gerektirir. Authorization header, kimlik bilgisini sorgu verisinden ayırdığı için önerilen varsayılan yöntemdir.

Önerilen yöntem

Authorization header

Bearer token

Authorization: Bearer YOUR_API_KEY değerini ayarlayın ve JSON gövdesinde yalnız girdi parametrelerini gönderin.

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" })
});

Alternatif yöntem

JSON gövdesinde API anahtarı

POST gövdesi

Anahtarı sorgu verinizle birlikte key özelliği olarak ekleyin. Bu yöntemi yalnız güvenilir sunucu tarafı kodunda kullanın.

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())

Kimlik bilgisi güvenliği

API anahtarınızı koruyun

  • Anahtarları sunucu ortam değişkenlerinde veya secrets manager içinde saklayın.
  • Anahtarı kaynak kod yönetimine göndermeyin ve tarayıcı JavaScript'inde açığa çıkarmayın.
  • Uygulama, proxy ve analiz loglarından kimlik bilgilerini çıkarın.
  • Her sorguda HTTPS kullanın; sızıntı ihtimalinde anahtarı yenileyin.

Hızlı karşılaştırma

Hangi yöntemi kullanmalısınız?

YöntemEn uygun kullanımKimlik bilgisi konumu
Bearer tokenÖnerilenÇoğu sunucu entegrasyonuAuthorization header
JSON gövdesiMevcut POST entegrasyonlarıkey özelliği
POST içerik türü: JSON sorgu gövdesi gönderirken Content-Type: application/json ayarlayın.

Sıradaki rehber

Tekli isim sorgusu gönderin

İsimden cinsiyetTekli sorgu parametreleri ve yanıtı →İstemci kütüphaneleriResmi SDK'lara dönün →