İçeriğe geç

Başlarken

Hızlı başlangıç

Anahtar oluştur, ilk isteğini gönder, ilk dosyanı yükle.

1. Anahtar oluştur

  1. drive.kivilio.com'da sağ üstteki profil menüsünden Geliştirici'yi aç.
  2. Yeni anahtar: bir ad ver (ör. "Blog sunucum"), yetkileri seç (okuma ve yazma çoğu iş için yeter), süreyi seç (önerilen 1 yıl).
  3. Anahtar yalnızca bir kez gösterilir. Kopyala ve sunucunda bir ortam değişkenine koy:
export KIVILIO_API_KEY=kvd_...

2. İlk istek

Drive'ım kökündeki öğeleri listeler:

# Anahtar ortam değişkeninde: export KIVILIO_API_KEY=kvd_...
curl -sS "https://drive.kivilio.com/api/v1/nodes" \
  -H "Authorization: Bearer $KIVILIO_API_KEY"

Yanıt:

{
  "items": [
    { "id": "0f8f…", "kind": "FOLDER", "name": "Belgeler", "visibility": "private", "...": "..." }
  ],
  "nextCursor": null
}

3. İlk dosyayı yükle

50 MB'a kadar dosyalar tek istekle yüklenir. Dosyanın adı sorgu dizesinde, türü Content-Type'ta:

# rapor.txt dosyasını Drive'ım köküne yükler (en fazla 50 MB).
curl -sS -X POST "https://drive.kivilio.com/api/v1/files?name=rapor.txt" \
  -H "Authorization: Bearer $KIVILIO_API_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary @rapor.txt

Yanıt yüklenen dosyadır (DriveNode). Dosya artık Drive'ında, kaynağı "API" olarak görünür.

4. Herkese açık yap (isteğe bağlı)

Anahtarın paylaşım yetkisi varsa dosyayı sabit bir adresle yayınlayabilirsin:

curl -sS -X PATCH "https://drive.kivilio.com/api/v1/nodes/$FILE_ID" \
  -H "Authorization: Bearer $KIVILIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"visibility":"public"}'
# Yanıttaki "publicUrl": https://files.kivilio.com/{public_id}/{ad}

Ayrıntılar: Gizlilik ve herkese açık adresler.