REST API

Elke mogelijkheid,
beschikbaar als API.

Het dashboard is niet het product. De API is dat. Elke actie in de Nimbu-UI is een call naar dezelfde REST API die jouw code kan doen. Als het platform het kan, kun je het vanuit code besturen.

Bekijk de docs Boek een demo

api ~ nimbu

# fetch published blog entries

$ curl https://api.nimbu.io/channels/blog/entries \

$ -H "Authorization: Bearer $NIMBU_TOKEN"

{"count":2,"results":[{"slug":"why-we-still-ship-liquid",...}]}

# same API the dashboard uses

Lees het zonder in te loggen

Een request en wat er terugkomt. Je hebt geen SDK nodig om de vorm te begrijpen, alleen een HTTP-call tegen dezelfde API die het dashboard gebruikt.

bash

# Fetch published entries from a channel

$ curl https://api.nimbu.io/channels/blog/entries \

$ -H "Authorization: Bearer $NIMBU_TOKEN" \

$ -H "Accept: application/json"

{"count": 2, "results": [{"id": "6620e1f0...",

"title_en": "Why we still ship Liquid",

"title_fr": "Pourquoi nous livrons toujours du Liquid",

"slug": "why-we-still-ship-liquid",

"status": "published", "published_at": "2026-05-14T09:12:00Z"}]}

# localized fields, one auth scheme, one contract

Eén API over content, commerce, klanten en zoeken

Het oppervlak is het hele platform. Content en custom data met channels en custom fields, geen migraties wanneer je een veld toevoegt. Commerce met varianten, prijsschema's en een orderautomaat met 13 states. Klanten met groepen, B2B-toegang en velden die encrypted at rest zijn met sleutels in de EU. Taalbewuste zoekfunctie over ongeveer 40 locales.

Geen tweederangs oppervlak Wat het dashboard kan, kan jouw code ook.
Voeg een veld toe en het zit in de API Geen migratie, geen redeploy. Het contract wordt op hetzelfde moment bijgewerkt.
Eén authenticatieschema voor alles OAuth2/OIDC en granulaire scopes over content, commerce en klanten.

Volledige API-referentie

endpoints

# content + custom data

$ GET /channels/{slug}/entries

$ POST /channels/{slug}/entries

# commerce

$ POST /products

$ GET /orders?status=paid

# customers + auth

$ POST /customers

# multilingual search

$ GET /search?q=linen&lang=fr

Authenticatie en contract

OAuth2 en OIDC, met scopes die jij beheert

Authenticatie gebeurt met OAuth2 en OpenID Connect, de standaard die je stack al spreekt. Scopes gelden per resource, voor lezen en schrijven. Een integratie die orders leest, krijgt een read-only scope op orders en niets meer. Een gelekte token van één integratie is geen sleutel tot het hele account.

Het contract is versioned. Een upgrade is een beslissing die je op je eigen moment neemt, geen verrassing op dinsdagochtend die een klantensite in productie breekt.

Granulaire read/write scopes Beperk integraties en agents tot exact het oppervlak dat ze nodig hebben.
Versioned contract Test en beweeg op je eigen moment. Breaking changes zijn geen verrassingen.
Standaard OAuth2/OIDC Geen eigen tokenschema om te reverse-engineeren.

Referentie over authenticatie

oauth

# exchange credentials for an access token

$ POST /oauth/token

{"access_token": "eyJ...", "token_type": "Bearer"}

# scoped per resource: read-only orders

$ GET /orders?status=paid

# OpenID Connect discovery

$ GET /.well-known/openid-configuration

# least privilege, versioned contract

Het platform pusht events waarvoor je anders zou pollen

Registreer een webhook op de events waar je om geeft en Nimbu stuurt een uitgaand HTTP-request wanneer ze afgaan, zowel voor content als commerce. Een gepubliceerd record triggert een cache purge of een static rebuild. Een betaalde order post naar fulfillment of naar de ERP van een klant. Een aangemaakte klant synct naar een CRM. Het platform is de source of truth en je andere systemen reageren erop.

Events voor content en commerce entry.published, order.paid, order.fulfilled, customer.created.
Geen polling nodig Nimbu belt jou. Je integratie reageert in real time.
Past in elke stack Nimbu is de source of truth. Je andere systemen abonneren zich erop.

Referentie over webhooks

webhooks

# register a webhook on order.paid

$ POST /webhooks

$ {"event": "order.paid",

$ "url": "https://erp.example.com/webhooks/nimbu"}

{"id": "wh_01", "event": "order.paid", "active": true}

# also: entry.published, customer.created,

# order.fulfilled, order.refunded

De taal waarin je al werkt

Je hoeft geen HTTP met de hand te schrijven om de API te gebruiken. De tooling is polyglot en publiek.

JS SDK

Typed client voor de REST API

Calls vanuit een Node-service of serverless functie lezen als method calls, niet als URL-strings. Typed, publiek en onderhouden naast de API.

npm install @nimbu/client

@nimbu/testing

Test voor het productie raakt

Test integratie- en Cloud Code-logica tegen in-memory fixtures voor het een live site raakt. Geen side effects in CI.

Referentie over testing

CLI en agent skill

35+ agents besturen dezelfde API

De nimbu CLI komt als open agent skill voor Claude Code, GitHub Copilot en 35+ agents. JSON- en TSV-output, authenticatie via de OS-keychain, read-only modus en allowlists van commando's.

Agent-native platform

Headless of getemplateerd

Zelfde model, jouw keuze van levering

Render server-side met Liquid themes, die git-based zijn en geen build step nodig hebben, of haal content over de API binnen in een statische frontend. Eén source of truth, in beide gevallen.

CMS en themes

Uit de praktijk

We hebben de orderdata van een klant op één namiddag rechtstreeks in hun ERP gekoppeld via de API. Door het versioned contract konden we opleveren, live gaan, en bleef de integratie antwoorden na de volgende platformupdate.

Developer, Zenjoy

De volledige referentie staat in de docs

Elk endpoint, elke parameter, scope en response is gedocumenteerd als OpenAPI-referentie op docs.nimbu.io. Deze pagina geeft de vorm. De docs geven het detail.