HUBNOVA DEVELOPERS · SANDBOX FIRST

Bouw met grenzen die je begrijpt.

Ontwerp, test en beheer HubNova-integraties vanuit één professionele sandbox met expliciete scopes, tijdelijke sleutels en betrouwbare events.

Tijdelijke sandboxkeys Expliciete scopes Request-ID op iedere call
30dagen maximale keyduur
6begrensde startscopes
0echte acties in sandbox
1×zichtbaar geheim
DEVELOPER WORKBENCH

Eén werkruimte voor de volledige integratiecyclus.

Van organisatie en app tot scopes, installaties, verzoeklogs en ondertekende webhooks. Sandbox en productie blijven technisch én visueel gescheiden.

WORKSPACE

Apps & organisaties

Scheid eigendom, teamrollen, apps en omgevingen helder van elkaar.

ACCESS

Keys & scopes

Eenmalig getoonde testkeys met beperkte rechten en vaste vervaldatum.

EVENTS

Webhooks

Stabiele event-ID’s, ondertekening, retries en gecontroleerde herbezorging.

OBSERVABILITY

Request Inspector

Status, duur en geschoonde foutcontext met een traceerbaar request-ID.

CONTRACT

OpenAPI 3.1

Eén contract voor validatie, documentatie en betrouwbare voorbeelden.

CONTROL

Installatiecontrole

Elke server en scope wordt afzonderlijk toegestaan, gepauzeerd of ingetrokken.

SANDBOX ARCHITECTURE

Test realistisch zonder echte communities te raken.

Synthetische servers en objecten volgen hetzelfde contract als de API, terwijl mutaties geen Discordberichten, betalingen of productieflows uitvoeren.

APISCOPESDATAEVENTSLOGS
HUBNOVA DEVELOPER DOCUMENTATION

Van eerste request tot betrouwbare integratie.

De documentatie hoort bij Developers en blijft hier direct naast de Console, voorbeelden en OpenAPI-definitie beschikbaar.

01 · QUICKSTART

Je eerste begrensde API-call

Maak in de Developer Console een organisatie, registreer een app en genereer een sandboxkey. Het geheim wordt één keer getoond.

curl https://hubnova.nl/v1/servers   -H "Authorization: Bearer hn_test_YOUR_KEY"
02 · AUTHENTICATION

Bearer credentials

Gebruik een sleutel uitsluitend server-side. Plaats hem nooit in browsercode, logs of openbare repositories.

Eenmalig zichtbaar

HubNova bewaart alleen een verifier en toont het oorspronkelijke geheim niet opnieuw.

03 · SCOPES

Vraag alleen wat je nodig hebt.

servers:readpublications:readevents:readroadmap:readtickets:createworkflows:run
04 · PROBLEM DETAILS

Fouten die machines én mensen begrijpen.

{
  "type": "https://hubnova.nl/problems/missing-scope",
  "title": "Missing scope",
  "status": 403,
  "code": "missing_scope",
  "requestId": "req_..."
}
05 · WEBHOOKS

Ondertekend, herhaalbaar en controleerbaar.

Ontvangers verwerken dubbele, vertraagde en anders geordende events idempotent. Een herbezorging verstuurt alleen hetzelfde event opnieuw.

06 · VERSIONING

Veranderen zonder verrassingen.

API- en eventschema’s hebben expliciete versies. Brekende wijzigingen krijgen een aangekondigde migratieperiode.

07 · REVOCATION

Toegang stopt direct en fail-closed.

Trek een sleutel of installatie in vanuit de Console. Normale API- en webhooktoegang stopt daarna direct.

KLAAR OM TE BOUWEN?

Start in de HubNova-sandbox.

Registreer je organisatie, ontwerp je eerste app en test ieder contract voordat je live toegang aanvraagt.

Open Developer Console →