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
Nubbo’da Ayarlar › API’yi açın (ekipteyseniz Ekip › API) ve API anahtarı oluştur’a basın.
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.

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.

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.

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.

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
| Pro | Ekipler | |
|---|---|---|
| Anahtar başına dakikadaki istek | 60 | 120 |
| Aylık istek | 50.000 | 100.000 + koltuk başına 10.000 |
| Aylık tetikleyici olayı | 20.000 | 50.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.

Bir sorun çıkarsa
API_KEY_INVALID,API_KEY_REVOKEDveyaAPI_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-Afteriçindeki saniye kadar bekleyin ve tekrar deneyin.API_QUOTA_EXCEEDED: alan aylık sınırını kullandı.details.resetsAtne 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.