Wespoke
Dokümantasyon

API Anahtarı Oluştur

Yeni bir API anahtarı oluşturun ve API'ye erişim sağlayın

Endpoint Bilgisi

POST/api-keys

Yeni bir API anahtarı oluşturur ve tam anahtarı döndürür.

⚠️ Önemli Güvenlik Notu

API anahtarı yalnızca oluşturulduğu anda tam olarak gösterilir. Anahtarı güvenli bir yerde saklayın, bir daha tam halini göremezsiniz.

İstek Parametreleri

namestringzorunlu

API anahtarı için açıklayıcı bir isim (örn: "Üretim Sunucusu", "Test Ortamı").

expiresAtstring (ISO 8601)opsiyonel

API anahtarının son kullanma tarihi. Belirtilmezse anahtarın süresi dolmaz.

İstek Örneği

cURL
curl -X POST https://api.wespoke.ai/api/v1/api-keys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Üretim API Anahtarı",
    "expiresAt": "2026-10-08T00:00:00Z"
  }'

Yanıt Örneği

201 Created
{
  "apiKey": {
    "id": "key_abc123xyz",
    "name": "Üretim API Anahtarı",
    "key": "sk_live_abc123xyz456789defghijklmnopqrstuvwxyz",
    "keyPrefix": "sk_live_abc123",
    "createdAt": "2025-10-08T15:30:00Z",
    "expiresAt": "2026-10-08T00:00:00Z"
  },
  "warning": "Bu anahtar yalnızca bir kez gösterilir. Lütfen güvenli bir yerde saklayın."
}

Yanıt Parametreleri

idstring

API anahtarının benzersiz kimliği.

namestring

API anahtarı için belirtilen isim.

keystring

Tam API anahtarı. Yalnızca oluşturma sırasında döndürülür.

keyPrefixstring

API anahtarının ilk karakterleri (güvenlik amacıyla).

createdAtstring (ISO 8601)

API anahtarının oluşturulma tarihi ve saati.

expiresAtstring (ISO 8601) | null

API anahtarının son kullanma tarihi. Süresi dolmuyorsa null.

Hata Yanıtları

400 Bad Request

{
  "error": {
    "code": "invalid_request",
    "message": "Geçersiz istek parametreleri",
    "details": {
      "name": "İsim alanı zorunludur"
    }
  }
}

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "Geçersiz veya eksik API anahtarı"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "API anahtar oluşturma limiti aşıldı. Lütfen daha sonra tekrar deneyin."
  }
}

En İyi Uygulamalar

  • •API anahtarlarınızı asla public repository'lerde veya client-side kodda saklamayın
  • •Her ortam için ayrı API anahtarları kullanın (test, staging, production)
  • •Kullanılmayan anahtarları düzenli olarak silin
  • •Kritik işlemler için son kullanma tarihi belirleyin
  • •API anahtarlarınızı environment variables veya secret management sistemlerinde saklayın
Anahtarları ListeleAsistanlar