Werken aan Boord / Documentatie

Werk vanuit je terminal.

Een klein Node.js-programma voor zoeken, browserlogin en publiceren. Geen extra pakketten nodig.

Lees als Markdown ↗

Download de CLI

Gebruik Node.js 22 of nieuwer. Download het bestand en voer een zoekopdracht uit.

Voorbeeld
curl --fail --output wab.mjs https://werkenaanboord.nl/cli/wab.mjs
node wab.mjs jobs --role schipper --limit 5

Vanuit deze repository

De repository biedt dezelfde CLI via public/cli/wab.mjs. Er is geen gepubliceerd npm-pakket nodig.

Voorbeeld
npm run cli -- jobs --role schipper --json

Zoeken en details lezen

Vervang de ID’s door waarden uit een zoekresultaat. Gebruik --cursor met next_cursor om verder te bladeren.

Voorbeeld
node wab.mjs taxonomy --json
node wab.mjs jobs --role schipper --work-type relief --available-from 2026-10-01 --available-to 2026-10-31 --json
node wab.mjs job VACATURE-ID --json
node wab.mjs workers --role schipper --needed-from 2026-10-12 --needed-to 2026-10-19 --json
node wab.mjs worker PROFIEL-ID --json

Inloggen

Open de getoonde link in een browser op dezelfde computer. Log in en keur de gevraagde toegang goed.

Voor profielen gebruik je --scope profile:write. Meerdere scopes mogen tussen aanhalingstekens, gescheiden door spaties.

De login gebruikt OAuth met PKCE en de gepubliceerde CLI-clientmetadata. De lokale callback gebruikt poort 43821.

Tokens staan in ~/.config/werken-aan-boord met beperkte bestandsrechten. De CLI vernieuwt verlopen tokens. Bij een geweigerde vernieuwing log je opnieuw in.

Voorbeeld
node wab.mjs login --scope jobs:write
node wab.mjs me --json

Voorbereiden en publiceren

Vervang de voorbeeldgegevens en de sleutel. Bewaar draft.json tot de publicatie is afgerond.

Na een onzekere netwerkuitkomst herhaal je precies dezelfde publicatie, met dezelfde sleutel. De CLI start geen automatische schrijfretry.

Gebruik prepare availability en publish availability voor een profiel met de eerste beschikbaarheid.

Voorbeeld
node wab.mjs prepare job --file vacature.json --json > draft.json
cat draft.json
# Alleen na akkoord op de volledige preview:
node wab.mjs publish job --file draft.json --confirm --idempotency-key EEN-UNIEKE-SLEUTEL --json

Voor scripts en agents

De CLI doet één aanvraag per zoekopdracht. Verwerk next_cursor in je script voor alle pagina’s.

Beheeracties zoals pauzeren en verwijderen zijn beschikbaar via REST en MCP.

OptieGedrag
--jsonVolledig API-antwoord op stdout; meldingen op stderr
--helpOpdrachten en zoekfilters
--confirmBevestigt de preview; voeg dit alleen toe na akkoord
WAB_TOKENBestaand OAuth-token; krijgt voorrang op lokale login
WAB_BASE_URLServer-origin; HTTPS of lokale HTTP voor ontwikkeling
WAB_CONFIG_DIRAndere map voor lokale tokens
Exitcode 1Validatie-, login-, netwerk- of API-fout

Lokale login verwijderen

Dit verwijdert de lokale tokens. Het trekt een elders gekopieerd token niet in. Verwijder ook WAB_TOKEN als je die gebruikt.

Voorbeeld
node wab.mjs logout