Οδηγοί

Ξεκίνα με το API του Nubbo

Από το μηδέν στο πρώτο σου αίτημα σε λίγα λεπτά. Δημιούργησε ένα κλειδί και διαχειρίσου το storage σου από τον δικό σου κώδικα.

Το API του Nubbo είναι ένα REST API για να δουλεύεις με τα buckets σου από τον δικό σου κώδικα: αρχεία, φάκελοι, σύνδεσμοι, αιτήματα αρχείων, γκαλερί, ετικέτες, έργα και αυτοματισμοί. Σε αυτόν τον οδηγό δημιουργείς ένα κλειδί και στέλνεις τα πρώτα σου αιτήματα με curl.

Τι κερδίζεις

  • Διαχειρίσου τον χώρο σου στο Nubbo από τα προγράμματά σου, με κλειδιά που βλέπουν μόνο ό,τι επιλέγεις.
  • Ανέβασε και κατέβασε απευθείας μεταξύ του κώδικά σου και του παρόχου αποθήκευσης.
  • Αντέδρασε σε νέα αρχεία, ανεβάσματα σε αιτήματα αρχείων και δραστηριότητα με τα triggers.

Πριν ξεκινήσεις

Χρειάζεσαι έναν λογαριασμό στο Nubbo με το πλάνο Pro ή Ομάδες και ένα τερματικό με curl. Σε μια ομάδα, τα κλειδιά API τα δημιουργούν ο κάτοχος ή ένας διαχειριστής.

Βήμα 1: δημιούργησε ένα κλειδί

  1. Στο Nubbo, άνοιξε Ρυθμίσεις › API (ή Ομάδα › API σε μια ομάδα) και πάτησε Δημιουργία κλειδιού API.

  2. Δώσε του ένα όνομα και διάλεξε:

    • Πρόσβαση: Μόνο ανάγνωση ή Ανάγνωση και εγγραφή.
    • Εμβέλεια: Όλος ο χώρος ή Επιλεγμένα buckets και έργα. Το κλειδί βλέπει μόνο ό,τι επιλέξεις εδώ.
    • Λήξη: 30 ημέρες, 90 ημέρες, 1 έτος ή Χωρίς λήξη. Το Nubbo σε ειδοποιεί 7 ημέρες πριν.

    Πάτησε Δημιουργία κλειδιού. Το Nubbo σού ζητά τον κωδικό σου για να επιβεβαιώσει ότι είσαι εσύ. Αν έχεις ενεργή την επαλήθευση δύο βημάτων, σού ζητά και τον κωδικό επαλήθευσης.

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

    Παράθυρο Το κλειδί API σου με το κλειδί έτοιμο για αντιγραφή Παράθυρο Το κλειδί API σου με το κλειδί έτοιμο για αντιγραφή

Βήμα 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, δεν υπάρχουν άλλα.

Τερματικό με το αίτημα GET /v1/me και την απάντησή του Τερματικό με το αίτημα GET /v1/me και την απάντησή του

Βήμα 3: η τεκμηρίωση

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

Τεκμηρίωση του API του Nubbo με το παράδειγμα curl Τεκμηρίωση του API του Nubbo με το παράδειγμα curl

Ανεβάσματα και λήψεις

Τα αρχεία δεν περνούν από το Nubbo. Για να ανεβάσεις ένα, ξεκίνα το ανέβασμα με POST /v1/buckets/{bucketId}/uploads, στείλε το αρχείο στην προϋπογεγραμμένη διεύθυνση που σου επιστρέφει και ολοκλήρωσε με POST /v1/uploads/{uploadId}/complete. Για λήψη, ζήτησε έναν σύνδεσμο με POST /v1/files/{fileId}/download-link και κατέβασέ το από τον πάροχό σου.

Όρια

ProΟμάδες
Αιτήματα ανά λεπτό ανά κλειδί60120
Αιτήματα τον μήνα50.000100.000 + 10.000 ανά θέση
Συμβάντα triggers τον μήνα20.00050.000 + 5.000 ανά θέση

Το όριο ανήκει στον χώρο και ανανεώνεται με κάθε περίοδο χρέωσης. Το GET /v1/me, οι έλεγχοι των triggers και οι απαντήσεις 401, 429 και 5xx δεν μετρούν ως αιτήματα. Κάθε συμβάν που παραδίδει ένα trigger μετρά ως συμβάν trigger. Κάθε απάντηση φέρνει τις κεφαλίδες X-RateLimit-Remaining και X-Nubbo-Quota-Requests-Remaining, και στις Ρυθμίσεις › API βλέπεις τη χρήση της περιόδου.

Χρήση του API της περιόδου στις ρυθμίσεις του Nubbo Χρήση του API της περιόδου στις ρυθμίσεις του Nubbo

Αν κάτι δεν πάει καλά

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

Πηγές

Τα βήματα ελέγχθηκαν με αυτές τις σελίδες.