Nubbo API je REST API za rad s tvojim bucketima iz vlastitog koda: datoteke, mape, poveznice, zahtjevi za datoteke, galerije, oznake, projekti i automatizacije. U ovom vodiču izrađuješ ključ i šalješ prve zahtjeve s curl.
Što dobivaš
- Upravljanje svojim Nubbo prostorom iz svojih programa, s ključevima koji vide samo ono što odabereš.
- Izravan prijenos i preuzimanje između tvog koda i tvog pružatelja pohrane.
- Reagiranje na nove datoteke, prijenose u zahtjeve za datoteke i aktivnost pomoću okidača.
Prije nego što počneš
Trebaš Nubbo račun s planom Pro ili Timovi i terminal s curl. U timu API ključeve izrađuju vlasnik ili administrator.
Korak 1: izradi ključ
U Nubbu otvori Postavke › API (ili Tim › API u timu) i pritisni Izradi API ključ.
Daj mu naziv i odaberi:
- Pristup: Samo čitanje ili Čitanje i pisanje.
- Doseg: Cijeli prostor ili Odabrani bucketi i projekti. Ključ vidi samo ono što ovdje odabereš.
- Istek: 30 dana, 90 dana, 1 godina ili Bez isteka. Nubbo te upozorava 7 dana prije.
Pritisni Izradi ključ. Nubbo traži tvoju lozinku da potvrdi da si to ti. Ako imaš uključenu provjeru u dva koraka, traži i kôd.

Kopiraj ključ i pritisni Ključ je spremljen. Počinje s
nbk_i samo ga sada vidiš cijelog. Spremi ga na poslužitelj ili u alat koji će ga koristiti, nikad na web stranicu.

Korak 2: tvoj prvi zahtjev
Pošalji ključ u zaglavlju Authorization svakog zahtjeva. Počni s GET /v1/me, koji ne troši zahtjeve:
curl https://api.nubbo.app/v1/me \
-H "Authorization: Bearer nbk_tvoj_kljuc"
Odgovor sadrži tvoj prostor, tvoj plan, mjesečnu kvotu i ključ s njegovim pristupom i dosegom. Ovo je izvadak:
{
"workspace": { "id": "…", "name": "Studio Sjever", "kind": "PERSONAL" },
"plan": "PRO",
"key": {
"name": "Moj prvi ključ",
"prefix": "nbk_3jKF3m",
"access": "READ",
"allResources": true
},
"quota": {
"requests": { "used": 0, "limit": 50000, "remaining": 50000 },
"events": { "used": 0, "limit": 20000, "remaining": 20000 },
"ratePerMinute": 60
}
}
Zatim ispiši svoje buckete i datoteke u mapi:
curl https://api.nubbo.app/v1/buckets \
-H "Authorization: Bearer nbk_tvoj_kljuc"
curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=racuni/" \
-H "Authorization: Bearer nbk_tvoj_kljuc"
Popisi vraćaju data i nextCursor. Za sljedeću stranicu pošalji tu vrijednost u cursor. Kad je nextCursor null, nema više.

Korak 3: referenca
U Postavke › API pritisni Pogledaj dokumentaciju ili otvori api.nubbo.app/v1/docs. Tamo je svaki resurs s poljima i primjerima. OpenAPI dokument nalazi se na api.nubbo.app/v1/openapi.json.

Prijenosi i preuzimanja
Datoteke ne prolaze kroz Nubbo. Za prijenos zatraži ga s POST /v1/buckets/{bucketId}/uploads, pošalji datoteku na unaprijed potpisanu adresu koju dobiješ i završi s POST /v1/uploads/{uploadId}/complete. Za preuzimanje zatraži poveznicu s POST /v1/files/{fileId}/download-link i preuzmi datoteku od svog pružatelja.
Ograničenja
| Pro | Timovi | |
|---|---|---|
| Zahtjeva u minuti po ključu | 60 | 120 |
| Zahtjeva mjesečno | 50.000 | 100.000 + 10.000 po mjestu |
| Događaja okidača mjesečno | 20.000 | 50.000 + 5.000 po mjestu |
Kvota pripada prostoru i obnavlja se sa svakim obračunskim razdobljem. GET /v1/me, provjere okidača i odgovori 401, 429 i 5xx ne računaju se kao zahtjevi. Svaki događaj koji okidač isporuči računa se kao događaj. Svaki odgovor sadrži zaglavlja X-RateLimit-Remaining i X-Nubbo-Quota-Requests-Remaining, a u Postavke › API vidiš potrošnju u razdoblju.

Ako nešto pođe po zlu
API_KEY_INVALID,API_KEY_REVOKEDiliAPI_KEY_EXPIRED: ključ ne vrijedi, opozvan je ili je istekao. Provjeri zaglavlje ili izradi novi ključ.API_PLAN_REQUIRED: prostor ključa nema API. Dostupan je u planovima Pro i Timovi.API_KEY_READ_ONLY: ključ je samo za čitanje. Izradi ključ s Čitanje i pisanje.API_RATE_LIMITED: previše zahtjeva s ovim ključem. Pričekaj sekunde izRetry-Afteri pokušaj ponovno.API_QUOTA_EXCEEDED: prostor je potrošio mjesečno ograničenje.details.resetsAtkaže kad se obnavlja.
Svaka greška sadrži requestId. Navedi ga ako nam pišeš.
Više o Nubbo API-ju. Za korištenje bez pisanja koda slijedi vodič za Zapier, za n8n ili za Make. Za korištenje iz svog AI asistenta pogledaj kako povezati Nubbo s Claudeom, ChatGPT-jem ili Cursorom.
Česta pitanja
Koji planovi uključuju API?
Pro i Timovi. S planom Besplatno ili Personal zahtjevi vraćaju API_PLAN_REQUIRED.
Mogu li API-jem čitati šifrirane datoteke?
Ne. Šifrirani sadržaj prikazuje se bez naziva, putanje, veličine i vrste, a svaka promjena na njemu odbija se s API_ENCRYPTED_CONTENT.
Što ako ponovim zahtjev zbog greške u mreži?
Šalji zaglavlje Idempotency-Key u svojim POST i PATCH zahtjevima. Tijekom 24 sata ponavljanje istog zahtjeva vraća prvi odgovor i ništa ne izrađuje dvaput.
Hoće li se API promijeniti bez najave?
Ne. Promjena koja nešto kvari dolazi kao /v2, a /v1 ostaje najmanje 12 mjeseci, sa zaglavljima Deprecation i Sunset.
Izvori
Koraci su provjereni prema ovim stranicama.