API-tokens

Een API-token gebruik je waar geen browser is om in te loggen: op een server, in een CI-pipeline of in je eigen scripts. Een token werkt alleen in de werkruimte waarin je hem maakt. Houd hem geheim, net als een wachtwoord.

Op je eigen computer heb je meestal geen token nodig: npx @cubli/cli login logt in via je browser.

Een token maken

1. Ga naar Instellingen, API-tokens en klik Token aanmaken.
2. Geef het een Naam naar waar je hem gebruikt, bijvoorbeeld “laptop” of “github-actions”.
3. Kies bij Wat mag het token?:
   • Deployen en beheren: de rechten van een beheerder.
   • Alleen lezen: kijken, niets wijzigen.
4. Kies bij Waar? of het token werkt voor Alle projecten in deze werkruimte of voor één project.
5. Klik Token aanmaken.

Je ziet het token, als kant-en-klaar commando om in te loggen. Kopieer het nu: het wordt maar één keer getoond. Klik Commando kopiëren.

Een token is 90 dagen geldig. In de lijst zie je wanneer hij verloopt, wie hem maakte en wanneer hij voor het laatst gebruikt is. Kijkers zien de pagina API-tokens niet.

Inloggen met een token

npx @cubli/cli login --token <token>

Of zet het token in de variabele CUBLI_TOKEN en draai npx @cubli/cli login. Daarna werken alle commando’s, zoals in een CI-stap:

npx @cubli/cli login --token "$CUBLI_TOKEN"
npx @cubli/cli up -m "deploy vanuit CI"

In CI heeft de map geen .cubli.json (die blijft buiten git). Draai daarom eerst npx @cubli/cli link --project <id>.

De API zelf

De CLI en de AI-tools gebruiken de API op https://api.cubli.io. Je kunt die ook zelf aanroepen, met je token als Bearer-token:

curl -H "Authorization: Bearer $CUBLI_TOKEN" https://api.cubli.io/v1/me

De volledige beschrijving van de API staat als OpenAPI op https://api.cubli.io/openapi.json. Een token heeft nooit meer rechten dan wie hem maakte.

Een token intrekken

Klik in de lijst bij het token op Intrekken. Het werkt daarna meteen niet meer. Een login met de CLI via de browser staat ook in deze lijst, en trek je op dezelfde manier in.