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).
messagemetinlerini 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.