Návody

Začněte s API Nubbo

Od nuly k prvnímu požadavku za pár minut. Vytvořte klíč a začněte spravovat své úložiště z vlastního kódu.

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íč

  1. V Nubbo otevřete Nastavení › API (nebo Tým › API v týmu) a stiskněte Vytvořit klíč API.

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

    Okno Vytvořit klíč API s přístupem, rozsahem a platností Okno Vytvořit klíč API s přístupem, rozsahem a platností
  3. 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.

    Okno Váš klíč API s klíčem připraveným ke zkopírování Okno Váš klíč API s klíčem připraveným ke zkopírování

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

Terminál s požadavkem GET /v1/me a jeho odpovědí Terminál s požadavkem GET /v1/me a jeho odpovědí

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.

Reference API Nubbo s příkladem curl Reference API Nubbo s příkladem curl

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

ProTýmy
Požadavky za minutu na klíč60120
Požadavky za měsíc50 000100 000 + 10 000 za místo
Události triggerů za měsíc20 00050 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í.

Využití API za období v nastavení Nubbo Využití API za období v nastavení Nubbo

Když něco selže

  • API_KEY_INVALID, API_KEY_REVOKED nebo API_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 z Retry-After a zkuste to znovu.
  • API_QUOTA_EXCEEDED: prostor vyčerpal svůj měsíční limit. details.resetsAt uvá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.