Die Nubbo-API ist eine REST-API, mit der du aus deinem eigenen Code mit deinen Buckets arbeitest: Dateien, Ordner, Links, Datei-Anfragen, Galerien, Labels, Projekte und Automatisierungen. In dieser Anleitung erstellst du einen Schlüssel und sendest deine ersten Anfragen mit curl.
Was du bekommst
- Verwalte deinen Nubbo-Bereich aus deinen Programmen, mit Schlüsseln, die nur sehen, was du auswählst.
- Lade Dateien direkt zwischen deinem Code und deinem Speicheranbieter hoch und herunter.
- Reagiere mit den Triggern auf neue Dateien, Uploads in Datei-Anfragen und Aktivität.
Bevor du anfängst
Du brauchst ein Nubbo-Konto mit dem Plan Pro oder Teams und ein Terminal mit curl. In einem Team erstellen der Inhaber oder ein Admin die API-Schlüssel.
Schritt 1: erstelle einen Schlüssel
Öffne in Nubbo Einstellungen › API (oder Team › API in einem Team) und klicke auf API-Schlüssel erstellen.
Gib ihm einen Namen und wähle:
- Zugriff: Nur lesen oder Lesen und schreiben.
- Umfang: Ganzer Bereich oder Ausgewählte Buckets und Projekte. Der Schlüssel sieht nur, was du hier auswählst.
- Ablauf: 30 Tage, 90 Tage, 1 Jahr oder Kein Ablaufdatum. Nubbo erinnert dich 7 Tage vorher.
Klicke auf Schlüssel erstellen. Nubbo fragt nach deinem Passwort, um zu bestätigen, dass du es bist. Wenn du die zweistufige Verifizierung aktiviert hast, fragt Nubbo auch nach dem Code.

Kopiere den Schlüssel und klicke auf Ich habe ihn gespeichert. Er beginnt mit
nbk_und du siehst ihn nur dieses eine Mal vollständig. Bewahre ihn auf dem Server oder in dem Tool auf, das ihn nutzt, nie in einer Webseite.

Schritt 2: deine erste Anfrage
Sende den Schlüssel bei jeder Anfrage im Header Authorization. Beginne mit GET /v1/me, das keine Anfragen verbraucht:
curl https://api.nubbo.app/v1/me \
-H "Authorization: Bearer nbk_dein_schluessel"
Die Antwort enthält deinen Bereich, deinen Plan, das Kontingent des Monats und den Schlüssel mit seinem Zugriff und Umfang. Hier ein Auszug:
{
"workspace": { "id": "…", "name": "Studio Nord", "kind": "PERSONAL" },
"plan": "PRO",
"key": {
"name": "Mein erster Schlüssel",
"prefix": "nbk_3jKF3m",
"access": "READ",
"allResources": true
},
"quota": {
"requests": { "used": 0, "limit": 50000, "remaining": 50000 },
"events": { "used": 0, "limit": 20000, "remaining": 20000 },
"ratePerMinute": 60
}
}
Liste danach deine Buckets und die Dateien eines Ordners auf:
curl https://api.nubbo.app/v1/buckets \
-H "Authorization: Bearer nbk_dein_schluessel"
curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=rechnungen/" \
-H "Authorization: Bearer nbk_dein_schluessel"
Listen liefern data und nextCursor. Für die nächste Seite sendest du diesen Wert in cursor. Ist nextCursor gleich null, gibt es nichts mehr.

Schritt 3: die Referenz
Klicke in Einstellungen › API auf Dokumentation ansehen oder öffne api.nubbo.app/v1/docs. Dort findest du jede Ressource mit ihren Feldern und Beispielen. Das OpenAPI-Dokument liegt unter api.nubbo.app/v1/openapi.json.

Uploads und Downloads
Dateien laufen nicht über Nubbo. Um eine hochzuladen, starte den Upload mit POST /v1/buckets/{bucketId}/uploads, sende die Datei an die vorsignierte Adresse aus der Antwort und schließe mit POST /v1/uploads/{uploadId}/complete ab. Zum Herunterladen fordere mit POST /v1/files/{fileId}/download-link einen Link an und lade die Datei von deinem Anbieter herunter.
Limits
| Pro | Teams | |
|---|---|---|
| Anfragen pro Minute und Schlüssel | 60 | 120 |
| Anfragen pro Monat | 50.000 | 100.000 + 10.000 pro Platz |
| Trigger-Ereignisse pro Monat | 20.000 | 50.000 + 5.000 pro Platz |
Das Kontingent gehört zum Bereich und erneuert sich mit jedem Abrechnungszeitraum. GET /v1/me, die Abfragen der Trigger und Antworten mit 401, 429 und 5xx zählen nicht als Anfragen. Jedes Ereignis, das ein Trigger liefert, zählt als Trigger-Ereignis. Jede Antwort enthält die Header X-RateLimit-Remaining und X-Nubbo-Quota-Requests-Remaining, und in Einstellungen › API siehst du die Nutzung des Zeitraums.

Wenn etwas schiefgeht
API_KEY_INVALID,API_KEY_REVOKEDoderAPI_KEY_EXPIRED: Der Schlüssel ist ungültig, wurde widerrufen oder ist abgelaufen. Prüfe den Header oder erstelle einen neuen Schlüssel.API_PLAN_REQUIRED: Der Bereich des Schlüssels enthält die API nicht. Sie ist in den Plänen Pro und Teams enthalten.API_KEY_READ_ONLY: Der Schlüssel kann nur lesen. Erstelle einen mit Lesen und schreiben.API_RATE_LIMITED: Zu viele Anfragen mit diesem Schlüssel. Warte die Sekunden ausRetry-Afterab und versuche es erneut.API_QUOTA_EXCEEDED: Der Bereich hat sein Monatslimit aufgebraucht.details.resetsAtsagt, wann es sich erneuert.
Jeder Fehler enthält eine requestId. Gib sie an, wenn du uns schreibst.
Mehr über die Nubbo-API. Um sie ohne Code zu nutzen, folge der Anleitung für Zapier, für n8n oder für Make. Um sie aus deinem KI-Assistenten zu nutzen, sieh dir an, wie du Nubbo mit Claude, ChatGPT oder Cursor verbindest.
Häufige Fragen
Welche Pläne enthalten die API?
Pro und Teams. Mit Kostenlos oder Personal antworten die Anfragen mit API_PLAN_REQUIRED.
Kann ich mit der API verschlüsselte Dateien lesen?
Nein. Verschlüsselte Inhalte erscheinen ohne Namen, Pfad, Größe oder Typ, und jede Änderung daran wird mit API_ENCRYPTED_CONTENT abgelehnt.
Was passiert, wenn ich eine Anfrage nach einem Netzwerkfehler wiederhole?
Sende bei POST und PATCH den Header Idempotency-Key mit. 24 Stunden lang liefert dieselbe Anfrage die erste Antwort zurück und legt nichts doppelt an.
Ändert sich die API ohne Vorwarnung?
Nein. Eine inkompatible Änderung kommt als /v2, und /v1 bleibt mindestens 12 Monate mit den Headern Deprecation und Sunset erhalten.
Quellen
Schritte mit diesen Seiten geprüft.