API değişiklik günlüğü
Herkese açık REST API’deki tarihli değişiklikler, en yenisi önce; API sürümü, değişiklik türü, etkilenen işlemler ve son kullanma tarihleri.
Bu değişiklik günlüğü, herkese açık REST API’deki değişiklikleri en yenisi önce olacak şekilde listeler. Her kayıt; tarihini, API sürümünü ve sözleşme sürümünü, değişikliğin türünü ve etkilediği işlemleri belirtir. Sözleşme sürümü, https://<api-host>/openapi.json adresindeki OpenAPI belgesinin info.version değeridir.
Uyumluluğu bozan bir değişiklik, yürürlüğe girmesinden en az 6 ay önce burada duyurulur. Kurallar için bkz. API sürümleme ve kullanımdan kaldırma.
| Tür | Anlamı |
|---|---|
| Eklendi | Yeni bir işlem, alan, başlık veya özellik. Geriye dönük uyumludur. |
| Değiştirildi | Değişen davranış. Genel kullanıma sunulmadan önce böyle bir değişiklik uyumluluğu bozabiliyordu. |
| Kullanımdan kaldırıldı | İşlem, son kullanma tarihine kadar çalışmaya devam eder; bu tarihten sonra kaldırılabilir veya değiştirilebilir. |
| Kaldırıldı | İşlem veya alan, son kullanma tarihinden sonra kaldırıldı. |
| Güvenlik | Bir güvenlik açığını kapatan değişiklik. |
2026-10-18
API sürümü v1, sözleşme sürümü 1.4.0.
Kullanımdan kaldırıldı
Bu işlemler kullanımdan kaldırıldı. Son kullanma tarihi: 2027-04-18. Yanıtları Deprecation, Sunset ve Link başlıklarını taşır.
Eklendi
- API’nin sürümleme ve kullanımdan kaldırma politikası.
- Kullanımdan kaldırılmış bir işlemin her yanıtında
Deprecation,SunsetveLinkbaşlıkları; OpenAPI belgesinde kullanımdan kaldırılmış işlemlerdex-deprecation-datevex-sunsetalanları.
Genel kullanıma sunulmadan önceki değişiklikler
Bu değişiklikler genel kullanıma sunulmadan önce yapıldı; bu nedenle bildirim süresine tabi değildi. API sürümü v1 için geçerlidir.
| Tarih | Tür | Değişiklik |
|---|---|---|
| 2026-10-19 | Değiştirildi | Bir API belirteci veya servis hesabı anahtarıyla Idempotency-Key başlığı yalnızca kaynak oluşturan ve 202 Accepted yanıtı veren POST isteklerinde zorunludur. DELETE, PATCH ve PUT istekleri ile mevcut kaynaklar üzerindeki eylemler yeniden anahtar olmadan kabul edilir. Bu isteklerle bir anahtar gönderdiğinizde, anahtarı kullanan işlemlerde aynı anahtarla yapılan yeniden deneme yine ilk yanıtı döndürür. API başvurusu, anahtarı yok sayan işlemlerde Idempotency-Key başlığını artık listelemez. |
| 2026-10-19 | Güvenlik | Uyumluluğu bozan değişiklik. API belirteciyle abonelik oluşturmak (POST /tenants/{tenantId}/subscriptions), iam:write kapsamına ek olarak billing:write kapsamını gerektirir. Bu kapsam olmadan istek, TOKEN_SCOPE_MISSING nedeniyle 403 Forbidden döndürür. Servis hesabı anahtarları reddedilmeye devam eder. |
| 2026-10-18 | Güvenlik | Servis hesabı anahtarlarının kapsamları vardır ve API belirteçleriyle aynı kapsam denetiminden geçer. Kapsam belirtilmeden oluşturulan bir anahtar, iam:write dışındaki tüm kapsamları alır. Bir anahtar iam:write kapsamına sahip olamaz: böyle bir istek 422 Unprocessable Entity döndürür. /tenants/ altındaki yazma işlemleri dahil iam:write gerektiren işlemler, servis hesabı anahtarlarını INTERACTIVE_SESSION_REQUIRED koduyla 403 Forbidden yanıtıyla reddeder. |
| 2026-10-18 | Eklendi | API ana bilgisayarı, https://<api-host>/docs adresinde etkileşimli bir API gezgini ve https://<api-host>/openapi.json adresinde OpenAPI belgesini sunar. |
| 2026-10-18 | Değiştirildi | Tüm öğeleri döndüren listeleme işlemleri artık page ve pageSize alır. pageSize 1–200 aralığındadır ve varsayılan değeri 200’dür. Daha büyük bir değer 422 Unprocessable Entity döndürür. |
| 2026-10-18 | Değiştirildi | OpenAPI belgesinin sunucusu, API ana bilgisayarındaki /api/v1 yoludur. Yayımlanan API referansı, API sözleşmesinden herkese açık olmayan işlemleri dışarıda bırakan bir kuralla oluşturulur. |
| 2026-10-18 | Değiştirildi | Bir API belirteci veya servis hesabı anahtarıyla yapılan bir yazma isteği, işlem bu başlığı alıyorsa Idempotency-Key başlığını taşımalıdır. Başlık olmadan istek IDEMPOTENCY_KEY_REQUIRED koduyla 400 Bad Request döndürür. Anahtarlar kuruluş başına tutulur; bu nedenle iki kuruluştaki aynı anahtar iki farklı isteği tanımlar. |
| 2026-10-18 | Değiştirildi | Bir API belirteci veya servis hesabı anahtarıyla yapılan istekler, kimlik bilgisi başına ve kuruluş başına sınırlanır. Yanıtları X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını taşır. Limiti aşan bir istek, RATE_LIMITED kodu ve bir Retry-After başlığıyla 429 Too Many Requests döndürür. |
| 2026-10-18 | Değiştirildi | Belirteç kapsamı kataloğunda 17 kapsam vardır; böylece API’nin her alanına açık bir kapsamla erişilebilir. OpenAPI belgesi, her işlemin gerektirdiği kapsamları x-required-scopes içinde listeler. Activity Log, iam:read veya audit:read kabul eder. Bir belirteç, kendisinde olmayan bir kapsamla belirteç veya anahtar oluşturamaz: details.reason değeri TOKEN_SCOPE_MISSING olan 403 Forbidden. Bir belirteç ayrıca kendisinden daha geç sona eren ya da IP izin listesi kendi listesinin içinde kalmayan bir belirteç de oluşturamaz: details.reason değeri TOKEN_FENCE_EXCEEDED olan 403 Forbidden. |
| 2026-10-17 | Güvenlik | Bir servis hesabını devre dışı bırakmak veya silmek, hesabın anahtarlarını ve oluşturduğu API belirteçlerini iptal eder. Hesabı yeniden etkinleştirmek bunları geri getirmez. Bir API belirtecinin özel sona erme tarihi en fazla 365 gün sonrası olabilir; daha geç bir tarih, details.reason değeri token_lifetime_exceeds_maximum olan 422 Unprocessable Entity döndürür. |
| 2026-10-17 | Eklendi | Activity Log olayları, çağıranın kimliğini nasıl doğruladığını belirten actorType alanını taşır: user, api_token, service_account_key veya system. Ayrıca çağrıyı yapan API belirtecinin veya servis hesabı anahtarının herkese açık ID’si olan credentialId alanını da taşır. |