API Nubbo je REST API pro práci s vašimi buckety z vlastního kódu: soubory, složky, odkazy, žádosti o soubory, galerie, štítky, projekty a automatizace. V tomto návodu vytvoříte klíč a pošlete první požadavky pomocí curl.
Co získáte
- Spravujte svůj prostor v Nubbo ze svých programů, s klíči, které vidí jen to, co vyberete.
- Nahrávejte a stahujte přímo mezi svým kódem a poskytovatelem úložiště.
- Reagujte pomocí triggerů na nové soubory, nahrání do žádostí o soubory a aktivitu.
Než začnete
Potřebujete účet Nubbo s tarifem Pro nebo Týmy a terminál s curl. V týmu vytvářejí klíče API vlastník nebo administrátor.
Krok 1: vytvořte klíč
V Nubbo otevřete Nastavení › API (nebo Tým › API v týmu) a stiskněte Vytvořit klíč API.
Pojmenujte ho a zvolte:
- Přístup: Pouze čtení nebo Čtení a zápis.
- Rozsah: Celý prostor nebo Vybrané buckety a projekty. Klíč vidí jen to, co tady vyberete.
- Platnost: 30 dní, 90 dní, 1 rok nebo Bez expirace. Nubbo vás upozorní 7 dní předem.
Stiskněte Vytvořit klíč. Nubbo si vyžádá vaše heslo, aby ověřil, že jste to vy. Pokud máte zapnuté dvoufázové ověření, vyžádá si i kód.

Zkopírujte klíč a stiskněte Mám ho uložený. Začíná na
nbk_a celý ho uvidíte jen tentokrát. Uložte ho na server nebo do nástroje, který ho bude používat, nikdy ne do webové stránky.

Krok 2: váš první požadavek
Posílejte klíč v hlavičce Authorization každého požadavku. Začněte s GET /v1/me, který nespotřebuje žádné požadavky:
curl https://api.nubbo.app/v1/me \
-H "Authorization: Bearer nbk_vas_klic"
Odpověď obsahuje váš prostor, váš tarif, kvótu měsíce a klíč s jeho přístupem a rozsahem. Toto je výňatek:
{
"workspace": { "id": "…", "name": "Studio Sever", "kind": "PERSONAL" },
"plan": "PRO",
"key": {
"name": "Můj první klíč",
"prefix": "nbk_3jKF3m",
"access": "READ",
"allResources": true
},
"quota": {
"requests": { "used": 0, "limit": 50000, "remaining": 50000 },
"events": { "used": 0, "limit": 20000, "remaining": 20000 },
"ratePerMinute": 60
}
}
Potom vypište své buckety a soubory ve složce:
curl https://api.nubbo.app/v1/buckets \
-H "Authorization: Bearer nbk_vas_klic"
curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=faktury/" \
-H "Authorization: Bearer nbk_vas_klic"
Seznamy vracejí data a nextCursor. Pro další stránku pošlete tuto hodnotu v cursor. Když je nextCursor null, nic dalšího už není.

Krok 3: reference
V Nastavení › API stiskněte Zobrazit dokumentaci, nebo otevřete api.nubbo.app/v1/docs. Najdete tam každý zdroj s jeho poli a příklady. Dokument OpenAPI je na api.nubbo.app/v1/openapi.json.

Nahrávání a stahování
Soubory neprocházejí přes Nubbo. Chcete-li nějaký nahrát, zahajte nahrávání pomocí POST /v1/buckets/{bucketId}/uploads, pošlete soubor na předem podepsanou adresu, kterou dostanete, a dokončete pomocí POST /v1/uploads/{uploadId}/complete. Ke stažení si vyžádejte odkaz pomocí POST /v1/files/{fileId}/download-link a stáhněte soubor od svého poskytovatele.
Limity
| Pro | Týmy | |
|---|---|---|
| Požadavky za minutu na klíč | 60 | 120 |
| Požadavky za měsíc | 50 000 | 100 000 + 10 000 za místo |
| Události triggerů za měsíc | 20 000 | 50 000 + 5 000 za místo |
Kvóta patří prostoru a obnovuje se s každým fakturačním obdobím. GET /v1/me, dotazy triggerů a odpovědi 401, 429 a 5xx se jako požadavky nepočítají. Každá událost, kterou trigger doručí, se počítá jako událost triggeru. Každá odpověď obsahuje hlavičky X-RateLimit-Remaining a X-Nubbo-Quota-Requests-Remaining a v Nastavení › API vidíte využití za období.

Když něco selže
API_KEY_INVALID,API_KEY_REVOKEDneboAPI_KEY_EXPIRED: klíč není platný, byl zrušen nebo vypršel. Zkontrolujte hlavičku nebo vytvořte jiný klíč.API_PLAN_REQUIRED: prostor klíče nezahrnuje API. Je součástí tarifů Pro a Týmy.API_KEY_READ_ONLY: klíč je pouze pro čtení. Vytvořte klíč s přístupem Čtení a zápis.API_RATE_LIMITED: příliš mnoho požadavků s tímto klíčem. Počkejte počet sekund zRetry-Aftera zkuste to znovu.API_QUOTA_EXCEEDED: prostor vyčerpal svůj měsíční limit.details.resetsAtuvádí, kdy se obnoví.
Každá chyba obsahuje requestId. Uveďte ho, pokud nám budete psát.
Více o API Nubbo. Chcete-li ho používat bez psaní kódu, postupujte podle návodu pro Zapier, pro n8n nebo pro Make. Chcete-li ho používat ze svého AI asistenta, podívejte se, jak připojit Nubbo ke Claude, ChatGPT nebo Cursoru.
Časté dotazy
Které tarify zahrnují API?
Pro a Týmy. S tarifem Zdarma nebo Personal odpovídají požadavky kódem API_PLAN_REQUIRED.
Mohu pomocí API číst zašifrované soubory?
Ne. Zašifrované položky se zobrazují bez názvu, cesty, velikosti a typu a každá jejich změna se odmítne s kódem API_ENCRYPTED_CONTENT.
Co se stane, když po výpadku sítě požadavek zopakuji?
U požadavků POST a PATCH posílejte hlavičku Idempotency-Key. Po 24 hodin vrátí opakování stejného požadavku první odpověď a nic se nevytvoří dvakrát.
Změní se API bez upozornění?
Ne. Nekompatibilní změna vyjde jako /v2 a /v1 zůstane nejméně 12 měsíců s hlavičkami Deprecation a Sunset.
Zdroje
Kroky jsou ověřené podle těchto stránek.