Vodiči

Započni s Nubbo API-jem

Od nule do prvog zahtjeva u nekoliko minuta. Izradi ključ i počni upravljati svojom pohranom iz vlastitog koda.

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č

  1. U Nubbu otvori Postavke › API (ili Tim › API u timu) i pritisni Izradi API ključ.

  2. 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.

    Prozor Izradi API ključ s pristupom, dosegom i istekom Prozor Izradi API ključ s pristupom, dosegom i istekom
  3. 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.

    Prozor Tvoj API ključ s ključem spremnim za kopiranje Prozor Tvoj API ključ s ključem spremnim za kopiranje

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.

Terminal sa zahtjevom GET /v1/me i njegovim odgovorom Terminal sa zahtjevom GET /v1/me i njegovim odgovorom

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.

Referenca Nubbo API-ja s primjerom u curl Referenca Nubbo API-ja s primjerom u curl

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

ProTimovi
Zahtjeva u minuti po ključu60120
Zahtjeva mjesečno50.000100.000 + 10.000 po mjestu
Događaja okidača mjesečno20.00050.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.

Potrošnja API-ja u razdoblju u Nubbovim postavkama Potrošnja API-ja u razdoblju u Nubbovim postavkama

Ako nešto pođe po zlu

  • API_KEY_INVALID, API_KEY_REVOKED ili API_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 iz Retry-After i pokušaj ponovno.
  • API_QUOTA_EXCEEDED: prostor je potrošio mjesečno ograničenje. details.resetsAt kaž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.