Kullanımdan kaldırma kullanım raporu

GET /v1/reports/deprecation-usage · izin reports:read

Kaldırılması planlanan işlemleri hâlâ çağıran istemcilerinizi gösterir; böylece kullanımdan kaldırma tarihinden önce bunları taşıyabilirsiniz (bkz. sürümleme politikası). Çağrılar UTC gününe göre sayılır ve kullanımdan kaldırma, istemci ve SDK sürümüne göre gruplanır. Hiçbir işlem kullanımdan kaldırılmamışsa rapor boştur.

Ortam her zaman API anahtarından gelir; ortam parametresi yoktur. Satırlarda IP adresi, User-Agent veya son kullanıcı tanımlayıcısı bulunmaz.

İstek

Parametre Konum Zorunlu Açıklama
from query hayır Dahil edilecek ilk gün, tam tarih (YYYY-MM-DD, UTC). Varsayılan, to tarihinden 30 gün öncesidir. Planınızın rapor geçmişiyle sınırlıdır (aşağıya bakın).
to query hayır Dahil edilecek son gün, tam tarih (YYYY-MM-DD, UTC). Varsayılan bugündür. from, to tarihinden sonra olamaz.
limit query hayır Sayfa boyutu, 1 ile 100 arası. Varsayılan 50.
cursor query hayır Önceki sayfanın next_cursor değeri. Yalnızca verildiği ortam, from ve to için geçerlidir.

Satırlar deprecation_id, client_id, sdk_package, sdk_version sırasına göre sıralanır. Aralığın her iki ucu da dahildir. Varsayılan aralıktan (from/to gönderilmeden) alınan bir imleç, UTC günü değiştiğinde geçersiz olur; sayfalama yaparken from ve to değerlerini açıkça gönderin.

Plana göre rapor geçmişi

Plan Geçmiş
Free 30 gün
Startup, Business 13 ay
Enterprise 25 ay, en fazla 400 gün

Rapor tablosu 400 gün tutulur; bu nedenle hiçbir plan 400 günden daha geriye gidemez. İzin verilen geçmişten daha eski bir from değeri 422 report_range_exceeds_plan ile başarısız olur; izin verilen en erken tarih mesajda ve errors[0].detail alanında (earliest_allowed_date=YYYY-MM-DD) yer alır.

Yanıt

200 OK. data sayfadaki satırları içerir; son sayfada next_cursor değeri null olur.

Alan Açıklama
deprecation_id Kullanımdan kaldırma kayıt defterindeki kimlik (dep-YYYY-NN).
client_id Yönetim API anahtarı için key_…, yönetim OAuth istemcisi için app_…, kontrol paneli için dashboard.
sdk_package Idp-Client başlığındaki SDK paketi; katalog dışındaki bir paket için other, başlık yoksa none.
sdk_version SemVer sürümü veya boş metin.
call_count Aralıktaki çağrı sayısı.
last_seen_at Aralıktaki son çağrı (RFC 3339, UTC).
sunset_at Kullanımdan kaldırma kayıt defterindeki kaldırma tarihi (YYYY-MM-DD); bilinmiyorsa null. Bu günden sonra işlem 410 endpoint_sunset yanıtı verir. 
{
  "data": [
    {
      "deprecation_id": "dep-2027-01",
      "client_id": "key_01j9xk3m7q8r2s4t6v8w0y2z4d",
      "sdk_package": "keenauth-go",
      "sdk_version": "1.4.0",
      "call_count": 1280,
      "last_seen_at": "2027-03-02T09:30:00Z",
      "sunset_at": "2028-01-17"
    }
  ],
  "next_cursor": null
}

CSV

Aynı sütunları başlık satırıyla birlikte CSV (RFC 4180) olarak almak için Accept: text/csv gönderin. =, +, -, @, sekme veya satır başı karakteriyle başlayan metin hücreleri, elektronik tablo programlarının bunları formül olarak çalıştırmaması için başına tek tırnak eklenerek yazılır. Sonraki sayfanın imleci Link başlığında (rel="next") yer alır; aralık o bağlantıda açıkça belirtilir.

deprecation_id,client_id,sdk_package,sdk_version,call_count,last_seen_at,sunset_at
dep-2027-01,key_01j9xk3m7q8r2s4t6v8w0y2z4d,keenauth-go,1.4.0,1280,2027-03-02T09:30:00Z,2028-01-17

Notlar

Sayımlar dakika bazında toplanır ve rapora eşzamansız olarak yazılır; bu nedenle en yeni çağrıların görünmesi birkaç dakika sürebilir. Bir çökme, 60 saniyeye kadar sayımın kaybolmasına yol açabilir. Rapor faturalandırma girdisi değildir.

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP code Ne zaman
400 invalid_filter from veya to bir YYYY-MM-DD tarihi değil, bir tarih tekrarlanmış veya from, to tarihinden sonra.
400 invalid_cursor İmleç bozuk veya bu ortam ve aralık için verilmemiş.
422 report_range_exceeds_plan from, planınızın rapor geçmişinden daha eski.
422 validation_failed limit aralık dışında veya bir parametre tekrarlanmış.
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Anahtarda reports:read izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After değerine uyun.
503 service_unavailable Raporlama servisi geçici olarak kullanılamıyor; daha sonra tekrar deneyin.

Örnek

curl "https://api.eu.keenauth.com/v1/reports/deprecation-usage?from=2027-03-01&to=2027-03-31" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth reports deprecation-usage --from 2027-03-01 --to 2027-03-31
keenauth reports deprecation-usage --format csv > deprecation-usage.csv