Το API του Nubbo είναι ένα REST API για να δουλεύεις με τα buckets σου από τον δικό σου κώδικα: αρχεία, φάκελοι, σύνδεσμοι, αιτήματα αρχείων, γκαλερί, ετικέτες, έργα και αυτοματισμοί. Σε αυτόν τον οδηγό δημιουργείς ένα κλειδί και στέλνεις τα πρώτα σου αιτήματα με curl.
Τι κερδίζεις
- Διαχειρίσου τον χώρο σου στο Nubbo από τα προγράμματά σου, με κλειδιά που βλέπουν μόνο ό,τι επιλέγεις.
- Ανέβασε και κατέβασε απευθείας μεταξύ του κώδικά σου και του παρόχου αποθήκευσης.
- Αντέδρασε σε νέα αρχεία, ανεβάσματα σε αιτήματα αρχείων και δραστηριότητα με τα triggers.
Πριν ξεκινήσεις
Χρειάζεσαι έναν λογαριασμό στο Nubbo με το πλάνο Pro ή Ομάδες και ένα τερματικό με curl. Σε μια ομάδα, τα κλειδιά API τα δημιουργούν ο κάτοχος ή ένας διαχειριστής.
Βήμα 1: δημιούργησε ένα κλειδί
Στο Nubbo, άνοιξε Ρυθμίσεις › API (ή Ομάδα › API σε μια ομάδα) και πάτησε Δημιουργία κλειδιού API.
Δώσε του ένα όνομα και διάλεξε:
- Πρόσβαση: Μόνο ανάγνωση ή Ανάγνωση και εγγραφή.
- Εμβέλεια: Όλος ο χώρος ή Επιλεγμένα buckets και έργα. Το κλειδί βλέπει μόνο ό,τι επιλέξεις εδώ.
- Λήξη: 30 ημέρες, 90 ημέρες, 1 έτος ή Χωρίς λήξη. Το Nubbo σε ειδοποιεί 7 ημέρες πριν.
Πάτησε Δημιουργία κλειδιού. Το Nubbo σού ζητά τον κωδικό σου για να επιβεβαιώσει ότι είσαι εσύ. Αν έχεις ενεργή την επαλήθευση δύο βημάτων, σού ζητά και τον κωδικό επαλήθευσης.

Αντίγραψε το κλειδί και πάτησε Το αποθήκευσα. Ξεκινά με
nbk_και είναι η μόνη φορά που θα το δεις ολόκληρο. Κράτησέ το στον server ή στο εργαλείο που θα το χρησιμοποιεί, ποτέ σε μια ιστοσελίδα.

Βήμα 2: το πρώτο σου αίτημα
Στείλε το κλειδί στην κεφαλίδα Authorization κάθε αιτήματος. Ξεκίνα με το GET /v1/me, που δεν καταναλώνει αιτήματα:
curl https://api.nubbo.app/v1/me \
-H "Authorization: Bearer nbk_to_kleidi_sou"
Η απάντηση φέρνει τον χώρο σου, το πλάνο σου, το όριο του μήνα και το κλειδί με την πρόσβαση και την εμβέλειά του. Αυτό είναι ένα απόσπασμα:
{
"workspace": { "id": "…", "name": "Στούντιο Βορράς", "kind": "PERSONAL" },
"plan": "PRO",
"key": {
"name": "Το πρώτο μου κλειδί",
"prefix": "nbk_3jKF3m",
"access": "READ",
"allResources": true
},
"quota": {
"requests": { "used": 0, "limit": 50000, "remaining": 50000 },
"events": { "used": 0, "limit": 20000, "remaining": 20000 },
"ratePerMinute": 60
}
}
Μετά, δες τα buckets σου και τα αρχεία ενός φακέλου:
curl https://api.nubbo.app/v1/buckets \
-H "Authorization: Bearer nbk_to_kleidi_sou"
curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=timologia/" \
-H "Authorization: Bearer nbk_to_kleidi_sou"
Οι λίστες επιστρέφουν data και nextCursor. Για την επόμενη σελίδα, στείλε αυτή την τιμή στο cursor. Όταν το nextCursor είναι null, δεν υπάρχουν άλλα.

Βήμα 3: η τεκμηρίωση
Στις Ρυθμίσεις › API, πάτησε Δες την τεκμηρίωση ή άνοιξε το api.nubbo.app/v1/docs. Εκεί είναι κάθε πόρος με τα πεδία και τα παραδείγματά του. Το έγγραφο OpenAPI βρίσκεται στο api.nubbo.app/v1/openapi.json.

Ανεβάσματα και λήψεις
Τα αρχεία δεν περνούν από το Nubbo. Για να ανεβάσεις ένα, ξεκίνα το ανέβασμα με POST /v1/buckets/{bucketId}/uploads, στείλε το αρχείο στην προϋπογεγραμμένη διεύθυνση που σου επιστρέφει και ολοκλήρωσε με POST /v1/uploads/{uploadId}/complete. Για λήψη, ζήτησε έναν σύνδεσμο με POST /v1/files/{fileId}/download-link και κατέβασέ το από τον πάροχό σου.
Όρια
| Pro | Ομάδες | |
|---|---|---|
| Αιτήματα ανά λεπτό ανά κλειδί | 60 | 120 |
| Αιτήματα τον μήνα | 50.000 | 100.000 + 10.000 ανά θέση |
| Συμβάντα triggers τον μήνα | 20.000 | 50.000 + 5.000 ανά θέση |
Το όριο ανήκει στον χώρο και ανανεώνεται με κάθε περίοδο χρέωσης. Το GET /v1/me, οι έλεγχοι των triggers και οι απαντήσεις 401, 429 και 5xx δεν μετρούν ως αιτήματα. Κάθε συμβάν που παραδίδει ένα trigger μετρά ως συμβάν trigger. Κάθε απάντηση φέρνει τις κεφαλίδες X-RateLimit-Remaining και X-Nubbo-Quota-Requests-Remaining, και στις Ρυθμίσεις › API βλέπεις τη χρήση της περιόδου.

Αν κάτι δεν πάει καλά
API_KEY_INVALID,API_KEY_REVOKEDήAPI_KEY_EXPIRED: το κλειδί δεν είναι έγκυρο, ανακλήθηκε ή έληξε. Έλεγξε την κεφαλίδα ή δημιούργησε άλλο κλειδί.API_PLAN_REQUIRED: ο χώρος του κλειδιού δεν έχει το API. Περιλαμβάνεται στα πλάνα Pro και Ομάδες.API_KEY_READ_ONLY: το κλειδί είναι μόνο για ανάγνωση. Δημιούργησε ένα με Ανάγνωση και εγγραφή.API_RATE_LIMITED: πάρα πολλά αιτήματα με αυτό το κλειδί. Περίμενε τα δευτερόλεπτα τουRetry-Afterκαι δοκίμασε ξανά.API_QUOTA_EXCEEDED: ο χώρος εξάντλησε το μηνιαίο όριό του. Τοdetails.resetsAtλέει πότε ανανεώνεται.
Κάθε σφάλμα φέρνει ένα requestId. Συμπερίλαβέ το αν μας γράψεις.
Περισσότερα για το API του Nubbo. Για να το χρησιμοποιήσεις χωρίς να γράψεις κώδικα, ακολούθησε τον οδηγό για το Zapier, για το n8n ή για το Make. Για να το χρησιμοποιήσεις από τον βοηθό AI σου, δες πώς να συνδέσεις το Nubbo με το Claude, το ChatGPT ή το Cursor.
Συχνές ερωτήσεις
Ποια πλάνα περιλαμβάνουν το API;
Το Pro και το Ομάδες. Με το Δωρεάν ή το Personal, τα αιτήματα απαντούν API_PLAN_REQUIRED.
Μπορώ να διαβάσω κρυπτογραφημένα αρχεία με το API;
Όχι. Το κρυπτογραφημένο περιεχόμενο εμφανίζεται χωρίς όνομα, διαδρομή, μέγεθος ή τύπο, και κάθε αλλαγή του απορρίπτεται με API_ENCRYPTED_CONTENT.
Τι γίνεται αν επαναλάβω ένα αίτημα μετά από σφάλμα δικτύου;
Στείλε την κεφαλίδα Idempotency-Key στα αιτήματα POST και PATCH. Για 24 ώρες, η επανάληψη του ίδιου αιτήματος επιστρέφει την πρώτη απάντηση και δεν δημιουργεί τίποτα δύο φορές.
Θα αλλάξει το API χωρίς προειδοποίηση;
Όχι. Μια ασύμβατη αλλαγή βγαίνει ως /v2, και το /v1 μένει τουλάχιστον 12 μήνες με τις κεφαλίδες Deprecation και Sunset.
Πηγές
Τα βήματα ελέγχθηκαν με αυτές τις σελίδες.