Anahtar Revoke / Silme

Bir anahtarı geçici (pasif) veya kalıcı olarak (sil) iptal edebilirsiniz. Her iki durumda da o anahtarla yeni token alınamaz, mevcut token süresi dolduğunda da yenilenemez.

Endpoint’ler

İşlem	Endpoint	Geri alınabilir mi?
Pasife al	`PUT /api/v1/tenants/me/api-keys/{id}` (`is_active: false`)	Evet — yeniden aktive edilebilir
Kalıcı sil	`DELETE /api/v1/tenants/me/api-keys/{id}`	Hayır — OAuth client kaydı da silinir

Bearer access token + tenant-admin rolü gerektirir.

Pasife alma

curl -X PUT https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name":  "Production — Ödeme Servisi",
    "contact_email": "ops@example.com",
    "is_active":     false
  }'

Pasife alma anında etkilidir — yeni token üretimi durur. Mevcut token’lar süre sonuna kadar (5dk) çalışır, sonra refresh edilemez. Geri aktive etmek için is_active: true ile aynı endpoint:

curl -X PUT https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name":  "Production — Ödeme Servisi",
    "contact_email": "ops@example.com",
    "is_active":     true
  }'

PUT, PATCH değildir — tüm güncellenebilir alanları göndermeniz gerekir. Sadece is_active field’ını göndermek diğer alanları sıfırlar. Anlık aktive/pasif için aynı objeyi alıp tek alanı değiştirin.

Kalıcı silme

curl -X DELETE https://identity.payven.com.tr/api/v1/tenants/me/api-keys/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN"

204 No Content — gövde yok.

Silme geri alınamaz. Identity kaydı ve OAuth client kaydı birlikte silinir. client_id değeri tekrar üretilmez — yeni bir anahtar oluşturmanız gerekir.

Ne zaman pasife alın, ne zaman silin?

Durum	Önerilen aksiyon
Anahtarın kullanılmadığını doğrulamak istiyorsunuz	Pasife al — birkaç hafta izleyip sonra silin
Sızıntı şüphesi var	Pasife al (anlık etki) → soruşturma → sil
Geçici servis kapatılıyor	Pasife al
Eski entegrasyon kalıcı kaldırıldı	Sil
Otomatik temizlik (CI/CD ile)	Sil — pasifleri bekletmeyin, audit kirletir

Hata response’ları

HTTP	`code`	Anlam
`404`	`api_key_not_found`	Anahtar bulunamadı
`403`	`forbidden`	`tenant-admin` rolü yok
`409`	`api_key_in_use`	Sistem kritik anahtarı (örn. last-active) silmeyi engelliyor — önce yeni anahtar yarat

Audit log

Tüm anahtar yaşam döngüsü olayları konsoldaki API Kayıtları → Audit ekranında loglanır:

Oluşturma (api_key.created)
Güncelleme (api_key.updated)
Rotasyon (api_key.secret_rotated)
Pasife alma / aktif etme (api_key.deactivated / api_key.activated)
Silme (api_key.deleted)
Kullanım — her token üretimi (api_key.used)

Bu kayıtlar PCI-DSS, ISO 27001 ve KVKK denetimlerinde audit trail olarak kullanılabilir.

Genel Bakış

Oturum Bilgisi

API Anahtarı Yönetimi

Lookup Servisleri

Doğrulama

Endpoint’ler

Pasife alma

Kalıcı silme

Ne zaman pasife alın, ne zaman silin?

Hata response’ları

Audit log

​Endpoint’ler

​Pasife alma

​Kalıcı silme

​Ne zaman pasife alın, ne zaman silin?

​Hata response’ları

​Audit log

Endpoint’ler

Pasife alma

Kalıcı silme

Ne zaman pasife alın, ne zaman silin?

Hata response’ları

Audit log