Nubboren APIa REST API bat da zure bucketekin zure kodetik lan egiteko: fitxategiak, karpetak, estekak, postontziak, galeriak, etiketak, proiektuak eta automatizazioak. Gida honetan gako bat sortzen duzu eta zure lehen eskaerak egiten dituzu curl-ekin.
Zer lortzen duzun
- Kudeatu zure Nubboko espazioa zure programetatik, zuk aukeratzen duzuna bakarrik ikusten duten gakoekin.
- Igo eta deskargatu zuzenean zure kodearen eta zure biltegiratze-hornitzailearen artean.
- Erreakzionatu fitxategi berriei, postontzietara egindako igoerei eta jarduerari abiarazleen bidez.
Hasi aurretik
Pro edo Taldeak planeko Nubbo kontu bat eta curl duen terminal bat behar dituzu. Talde batean, jabeak edo administratzaile batek sortzen ditu API gakoak.
1. urratsa: sortu gako bat
Nubbon, ireki Ezarpenak › API (edo Taldea › API talde batean) eta sakatu Sortu API gakoa.
Eman izen bat eta aukeratu:
- Sarbidea: Irakurtzeko soilik edo Irakurtzeko eta idazteko.
- Irismena: Espazio osoa edo Aukeratutako bucketak eta proiektuak. Gakoak hemen aukeratzen duzuna bakarrik ikusten du.
- Iraungitzea: 30 egun, 90 egun, urte 1 edo Iraungitzerik gabe. Nubbok 7 egun lehenago abisatzen dizu.
Sakatu Sortu gakoa. Nubbok zure pasahitza eskatzen dizu zu zarela berresteko. Bi urratseko egiaztapena aktibatuta baduzu, kodea ere eskatzen dizu.

Kopiatu gakoa eta sakatu Gorde dut.
nbk_aurrizkiarekin hasten da, eta oraingo honetan bakarrik ikusiko duzu osorik. Gorde zerbitzarian edo hura erabiliko duen tresnan, inoiz ez web orri batean.

2. urratsa: zure lehen eskaera
Bidali gakoa eskaera bakoitzaren Authorization goiburuan. Hasi GET /v1/me eskaerarekin, ez baitu eskaerarik kontsumitzen:
curl https://api.nubbo.app/v1/me \
-H "Authorization: Bearer nbk_zure_gakoa"
Erantzunak zure espazioa, zure plana, hilabeteko kuota eta gakoa bere sarbidearekin eta irismenarekin dakartza. Hau zati bat da:
{
"workspace": { "id": "…", "name": "Ipar Estudioa", "kind": "PERSONAL" },
"plan": "PRO",
"key": {
"name": "Nire lehen gakoa",
"prefix": "nbk_3jKF3m",
"access": "READ",
"allResources": true
},
"quota": {
"requests": { "used": 0, "limit": 50000, "remaining": 50000 },
"events": { "used": 0, "limit": 20000, "remaining": 20000 },
"ratePerMinute": 60
}
}
Ondoren, zerrendatu zure bucketak eta karpeta bateko fitxategiak:
curl https://api.nubbo.app/v1/buckets \
-H "Authorization: Bearer nbk_zure_gakoa"
curl "https://api.nubbo.app/v1/buckets/<bucketId>/files?prefix=fakturak/" \
-H "Authorization: Bearer nbk_zure_gakoa"
Zerrendek data eta nextCursor itzultzen dituzte. Hurrengo orrirako, bidali balio hori cursor eremuan. nextCursor null denean, ez dago gehiago.

3. urratsa: erreferentzia
Ezarpenak › API atalean, sakatu Ikusi dokumentazioa, edo ireki api.nubbo.app/v1/docs. Han dago baliabide bakoitza bere eremu eta adibideekin. OpenAPI dokumentua api.nubbo.app/v1/openapi.json helbidean dago.

Igoerak eta deskargak
Fitxategiak ez dira Nubbotik igarotzen. Bat igotzeko, hasi igoera POST /v1/buckets/{bucketId}/uploads eskaerarekin, bidali fitxategia itzultzen dizun aurrez sinatutako helbidera eta amaitu POST /v1/uploads/{uploadId}/complete eskaerarekin. Deskargatzeko, eskatu esteka bat POST /v1/files/{fileId}/download-link eskaerarekin eta deskargatu zure hornitzailetik.
Mugak
| Pro | Taldeak | |
|---|---|---|
| Eskaerak minutuko gako bakoitzeko | 60 | 120 |
| Eskaerak hilean | 50.000 | 100.000 + 10.000 plaza bakoitzeko |
| Abiarazleen gertaerak hilean | 20.000 | 50.000 + 5.000 plaza bakoitzeko |
Kuota espazioarena da eta fakturazio-aldi bakoitzarekin berritzen da. GET /v1/me, abiarazleen kontsultak eta 401, 429 eta 5xx erantzunak ez dira eskaera gisa zenbatzen. Abiarazle batek entregatzen duen gertaera bakoitza abiarazle-gertaera gisa zenbatzen da. Erantzun bakoitzak X-RateLimit-Remaining eta X-Nubbo-Quota-Requests-Remaining goiburuak dakartza, eta Ezarpenak › API atalean aldiko erabilera ikusten duzu.

Zerbait huts egiten badu
API_KEY_INVALID,API_KEY_REVOKEDedoAPI_KEY_EXPIRED: gakoa ez da baliozkoa, baliogabetu egin da edo iraungi da. Berrikusi goiburua edo sortu beste gako bat.API_PLAN_REQUIRED: gakoaren espazioak ez du APIa. Pro eta Taldeak planetan dago.API_KEY_READ_ONLY: gakoa irakurtzeko soilik da. Sortu bat Irakurtzeko eta idazteko sarbidearekin.API_RATE_LIMITED: eskaera gehiegi gako honekin. ItxaronRetry-Aftergoiburuko segundoak eta saiatu berriro.API_QUOTA_EXCEEDED: espazioak hilabeteko muga agortu du.details.resetsAteremuak noiz berritzen den esaten du.
Errore bakoitzak requestId bat dakar. Sartu idazten badiguzu.
Informazio gehiago: Nubboren APIa. Kodea idatzi gabe erabiltzeko, jarraitu Zapier, n8n edo Make gida. Zure AA laguntzailetik erabiltzeko, ikusi nola konektatu Nubbo Claude, ChatGPT edo Cursorrekin.
Ohiko galderak
Zer planek dute APIa?
Pro eta Taldeak planek. Doakoa edo Personal planarekin, eskaerek API_PLAN_REQUIRED erantzuten dute.
Fitxategi enkriptatuak irakur ditzaket APIarekin?
Ez. Eduki enkriptatua izenik, biderik, tamainarik eta motarik gabe agertzen da, eta haren gaineko edozein aldaketa API_ENCRYPTED_CONTENT kodearekin baztertzen da.
Zer gertatzen da sareko akats baten ondoren eskaera bat errepikatzen badut?
Bidali Idempotency-Key goiburua POST eta PATCH eskaeretan. 24 orduz, eskaera bera errepikatzeak lehen erantzuna itzultzen du eta ez du ezer bi aldiz sortzen.
Abisatu gabe aldatuko da APIa?
Ez. Aldaketa bateraezin bat /v2 gisa aterako da, eta /v1 gutxienez 12 hilabetez mantenduko da Deprecation eta Sunset goiburuekin.
Iturriak
Orri hauekin egiaztatutako urratsak.