Paylaşılan sırlar

Gizli Kelime Doğrulama

API anahtarına tanımlanmış gizli kelimeyi, istekte gönderilen değerle karşılaştırır. Kelime veritabanında hashlenmiş olarak saklanır.

POST/verify/keyword API anahtarı zorunlu

İstek parametreleri

Alan Tür Zorunlu Açıklama
keyword string Evet API anahtarı için tanımlanmış gizli kelime. Büyük/küçük harfe duyarlıdır.

Örnek istek

curl
curl -X POST https://api.craftfix.com.tr/verify/keyword \
  -H "X-API-Key: cfk_live_9f2c4a7d1e6b8c3f" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"craftfix-2026"}'

Örnek yanıt

200 OK · application/json
{
    "success": true,
    "valid": true,
    "method": "keyword",
    "message": "Gizli kelime doğrulandı.",
    "data": {
        "keyword_verified": true
    },
    "meta": {
        "request_id": "req_9f3a1c7b2d4e6f80",
        "timestamp": "2026-01-01T12:00:00+03:00"
    }
}

Notlar

  • Gizli kelime yönetici panelinden API anahtarına tanımlanır.
  • Kelime karşılaştırması büyük/küçük harfe duyarlıdır ve düz metin olarak saklanmaz.
  • Yanlış denemeler Doğrulama Kayıtları ekranında görüntülenebilir.

Hata kodları

Kod HTTP Açıklama
missing_api_key 401 API anahtarı doğru değil. İstekte X-API-Key başlığı, Bearer jetonu veya api_key alanı bulunmuyor.
invalid_api_key 401 API anahtarı doğru değil. Gönderilen anahtar sistemde kayıtlı değil.
inactive_api_key 401 API anahtarı doğru değil. Anahtar devre dışı bırakılmış.
account_disabled 403 API anahtarının bağlı olduğu kullanıcı hesabı devre dışı.
rate_limited 429 API anahtarı için dakikalık istek sınırı aşıldı.
server_error 500 Sunucu tarafında beklenmeyen bir hata oluştu.
missing_keyword 422 keyword alanı gönderilmedi.
keyword_not_set 403 API anahtarı için gizli kelime tanımlanmamış.
keyword_mismatch 403 Gönderilen gizli kelime eşleşmedi.