Kılavuzlar

Nubbo API ile başlayın

Sıfırdan ilk isteğinize birkaç dakikada. Bir anahtar oluşturun ve depolamanızı kendi kodunuzdan yönetmeye başlayın.

Nubbo API, bucket’larınızla kendi kodunuzdan çalışmanızı sağlayan bir REST API’dir: dosyalar, klasörler, bağlantılar, dosya istekleri, galeriler, etiketler, projeler ve otomasyonlar. Bu kılavuzda bir anahtar oluşturur ve curl ile ilk isteklerinizi gönderirsiniz.

Neler elde edersiniz

  • Nubbo alanınızı programlarınızdan, yalnızca sizin seçtiklerinizi gören anahtarlarla yönetin.
  • Kodunuz ile depolama sağlayıcınız arasında doğrudan yükleyin ve indirin.
  • Tetikleyicilerle yeni dosyalara, dosya isteklerine yapılan yüklemelere ve etkinliğe tepki verin.

Başlamadan önce

Pro veya Ekipler planında bir Nubbo hesabına ve curl yüklü bir terminale ihtiyacınız var. Bir ekipte API anahtarlarını sahip veya bir yönetici oluşturur.

Adım 1: bir anahtar oluşturun

  1. Nubbo’da Ayarlar › API’yi açın (ekipteyseniz Ekip › API) ve API anahtarı oluştur’a basın.

  2. Bir ad verin ve şunları seçin:

    • Erişim: Yalnızca okuma veya Okuma ve yazma.
    • Kapsam: Tüm alan veya Seçilen bucket’lar ve projeler. Anahtar yalnızca burada seçtiklerinizi görür.
    • Sona erme: 30 gün, 90 gün, 1 yıl veya Süresiz. Nubbo size 7 gün önce hatırlatır.

    Anahtar oluştur’a basın. Nubbo, siz olduğunuzu onaylamak için şifrenizi ister. İki adımlı doğrulama açıksa kodu da ister.

    Erişim, kapsam ve sona erme seçenekleriyle API anahtarı oluştur penceresi Erişim, kapsam ve sona erme seçenekleriyle API anahtarı oluştur penceresi
  3. Anahtarı kopyalayın ve Kaydettim’e basın. Anahtar nbk_ ile başlar ve onu tam olarak yalnızca bu kez görürsünüz. Onu sunucuda veya onu kullanacak araçta saklayın, asla bir web sayfasında değil.

    Anahtar kopyalanmaya hazır API anahtarınız penceresi Anahtar kopyalanmaya hazır API anahtarınız penceresi

Adım 2: ilk isteğiniz

Anahtarı her isteğin Authorization başlığında gönderin. İstek harcamayan GET /v1/me ile başlayın:

curl https://api.nubbo.app/v1/me \
  -H "Authorization: Bearer nbk_anahtariniz"

Yanıtta alanınız, planınız, ayın kotası ve erişimi ile kapsamıyla birlikte anahtar yer alır. Bu bir alıntıdır:

{
  "workspace": { "id": "…", "name": "Kuzey Stüdyo", "kind": "PERSONAL" },
  "plan": "PRO",
  "key": {
    "name": "İlk anahtarım",
    "prefix": "nbk_3jKF3m",
    "access": "READ",
    "allResources": true
  },
  "quota": {
    "requests": { "used": 0, "limit": 50000, "remaining": 50000 },
    "events": { "used": 0, "limit": 20000, "remaining": 20000 },
    "ratePerMinute": 60
  }
}

Ardından bucket’larınızı ve bir klasörün dosyalarını listeleyin:

curl https://api.nubbo.app/v1/buckets \
  -H "Authorization: Bearer nbk_anahtariniz"

curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=faturalar/" \
  -H "Authorization: Bearer nbk_anahtariniz"

Listeler data ve nextCursor döndürür. Sonraki sayfa için bu değeri cursor içinde gönderin. nextCursor null olduğunda başka sonuç yoktur.

GET /v1/me isteği ve yanıtıyla terminal GET /v1/me isteği ve yanıtıyla terminal

Adım 3: başvuru

Ayarlar › API’de Belgeleri görüntüle’ye basın veya api.nubbo.app/v1/docs adresini açın. Her kaynak alanları ve örnekleriyle oradadır. OpenAPI belgesi api.nubbo.app/v1/openapi.json adresindedir.

curl örneğiyle Nubbo API başvurusu curl örneğiyle Nubbo API başvurusu

Yüklemeler ve indirmeler

Dosyalar Nubbo’dan geçmez. Bir dosya yüklemek için yüklemeyi POST /v1/buckets/{bucketId}/uploads ile başlatın, dosyayı döndürülen önceden imzalanmış adrese gönderin ve POST /v1/uploads/{uploadId}/complete ile bitirin. İndirmek için POST /v1/files/{fileId}/download-link ile bir bağlantı isteyin ve dosyayı sağlayıcınızdan indirin.

Sınırlar

ProEkipler
Anahtar başına dakikadaki istek60120
Aylık istek50.000100.000 + koltuk başına 10.000
Aylık tetikleyici olayı20.00050.000 + koltuk başına 5.000

Kota alana aittir ve her fatura döneminde yenilenir. GET /v1/me, tetikleyici sorguları ve 401, 429 ve 5xx yanıtları istek sayılmaz. Bir tetikleyicinin teslim ettiği her olay, olay olarak sayılır. Her yanıt X-RateLimit-Remaining ve X-Nubbo-Quota-Requests-Remaining başlıklarını taşır ve dönemin kullanımını Ayarlar › API’de görürsünüz.

Nubbo ayarlarında dönemin API kullanımı Nubbo ayarlarında dönemin API kullanımı

Bir sorun çıkarsa

  • API_KEY_INVALID, API_KEY_REVOKED veya API_KEY_EXPIRED: anahtar geçersiz, iptal edilmiş veya süresi dolmuş. Başlığı kontrol edin ya da başka bir anahtar oluşturun.
  • API_PLAN_REQUIRED: anahtarın alanında API yok. API, Pro ve Ekipler planlarında bulunur.
  • API_KEY_READ_ONLY: anahtar yalnızca okuma içindir. Okuma ve yazma ile bir anahtar oluşturun.
  • API_RATE_LIMITED: bu anahtarla çok fazla istek gönderildi. Retry-After içindeki saniye kadar bekleyin ve tekrar deneyin.
  • API_QUOTA_EXCEEDED: alan aylık sınırını kullandı. details.resetsAt ne zaman yenileneceğini söyler.

Her hata bir requestId taşır. Bize yazarsanız onu ekleyin.

Nubbo API hakkında daha fazlası. Kod yazmadan kullanmak için Zapier, n8n veya Make kılavuzunu izleyin. Yapay zeka asistanınızdan kullanmak için Nubbo’yu Claude, ChatGPT veya Cursor’a nasıl bağlayacağınıza bakın.

Sıkça sorulan sorular

Hangi planlarda API var?

Pro ve Ekipler. Ücretsiz veya Personal planda istekler API_PLAN_REQUIRED yanıtını verir.

API ile şifrelenmiş dosyaları okuyabilir miyim?

Hayır. Şifrelenmiş öğeler ad, yol, boyut ve tür olmadan görünür ve üzerlerindeki her değişiklik API_ENCRYPTED_CONTENT ile reddedilir.

Bir ağ hatası yüzünden isteği tekrarlarsam ne olur?

POST ve PATCH isteklerinizde Idempotency-Key başlığını gönderin. 24 saat boyunca aynı isteği tekrarlamak ilk yanıtı döndürür ve hiçbir şeyi iki kez oluşturmaz.

API haber verilmeden değişir mi?

Hayır. Bir şeyi bozan değişiklik /v2 olarak gelir ve /v1, Deprecation ve Sunset başlıklarıyla en az 12 ay kalır.

Kaynaklar

Adımlar bu sayfalara göre kontrol edildi.