Başlarken
Hızlı başlangıç
Anahtar oluştur, ilk isteğini gönder, ilk dosyanı yükle.
1. Anahtar oluştur
- drive.kivilio.com'da sağ üstteki profil menüsünden Geliştirici'yi aç.
- 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).
- 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.txtYanı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.