İçeriğe geç

Başvuru

Sürümleme ve değişiklik günlüğü

v1 sözleşmesi, neyin kırıcı sayıldığı ve değişiklikler.

API'nin adresi sürümü taşır: /api/v1. v1 herkese açık bir sözleşmedir.

Kırıcı sayılmayan değişiklikler

Bunlar duyurusuz yapılabilir; istemcin bunlara dayanıklı olmalı:

  • Yanıtlara yeni alan eklemek (bilmediğin alanları yok say).
  • Yeni uç, yeni isteğe bağlı parametre ya da başlık eklemek.
  • Yeni hata kodu eklemek (tanımadığın kodu HTTP durumuna göre ele al).
  • message metinlerini değiştirmek.
  • Hız sınırlarını değiştirmek (başlıklara bak).

Kırıcı değişiklikler

Bunlar yalnızca yeni bir sürümle (/api/v2) gelir; v1 bir süre birlikte çalışır:

  • Alan silmek, adını ya da türünü değiştirmek.
  • Zorunlu yeni parametre eklemek.
  • Bir hata kodunun anlamını değiştirmek.

OpenAPI

Sözleşmenin makinece okunur hali: /openapi.json (OpenAPI 3.1). Aynı belge https://drive.kivilio.com/api/v1/openapi.json adresinde de var.

Değişiklik günlüğü

Kasım 2026: v1 dışarıya açıldı

  • Kişisel API anahtarları (kvd_…), klasörle sınırlama.
  • Basit yükleme (POST /files), Idempotency-Key.
  • Dosya gizliliği (visibility) ve herkese açık adresler (files.kivilio.com).
  • Tek tip hata gövdesi (requestId), hız sınırı başlıkları.
  • Uygulama klasörleri salt okunur.