CLI-handleiding

Je bedrijfsrechten en dienstgegevens

Je verbinding is beperkt tot de actuele bedrijfsrechten en de scopes waarvoor je toestemming hebt gegeven. Interne registraridentiteiten en object-ID’s ontbreken in klantantwoorden, ook bij veldselectie en filters. Bedrijfseigendom geeft geen platformbeheerdersrechten. DNS-koppelingen die je zelf kiest blijven zichtbaar waar dat nodig is voor DNS-beheer.

• managed_by_binadit: of Binadit de domeinregistratie beheert, zoals het portaal dat aangeeft.
• invoice_number / invoice_id: het factuurnummer en het lokale factuur-ID dat bij een bestelling hoort.
• billing_mode: managed: een bestaande beheerde factuurafspraak voor een domein, zonder het achterliggende facturatiesysteem te noemen.

Historische resultaten volgen dezelfde regels voor publieke velden. Je kunt alleen een opdracht bekijken die via je eigen verbinding is verstuurd. Het resultaat kan null zijn als de actuele rechten de inhoud niet toestaan of de oorspronkelijke actie niet kan worden gecontroleerd. Een beperkte verbinding krijgt ook alleen de status zonder historische inhoud. Dit geeft geen toestemming om een vervangend verzoek te versturen.

Installeer de CLI

minisign -Vm SHA256SUMS -p binadit-release.pub

Bouw lokaal vanuit de broncode

De CLI wordt lokaal gebouwd en gecontroleerd. Gebruik een binary met checksum die door je beheerder is gepubliceerd, of bouw vanuit de cli-map van de gereviewde repository. Er worden hiervoor geen GitHub-builds gebruikt.

cd cli
cargo build --locked
./target/debug/binadit --help

De CLI is geschreven in Rust en ondersteunt macOS (Apple Silicon en Intel), Linux x64 en Windows x64. Linux ARM64 wordt niet gepubliceerd. Voor releasebinaries heb je geen Rust, PHP of Node.js nodig. Gebruik voor lokale broncodebuilds de vastgezette cli/rust-toolchain.toml.

Log in en kies een bedrijf

De CLI opent je gewone browser. Log in bij Binadit, selecteer het bedrijf en bevestig de gevraagde rechten. Keer na toestemming terug naar de terminal. De CLI gebruikt de beveiligde credentialopslag van het besturingssysteem en slaat geen tokens op in het configuratiebestand. Gewone opdrachten vernieuwen hun toegangstoken automatisch en vragen niet telkens je passkey; gebruik je bestaande profiel. De persoonlijke verbinding vervalt na maximaal 30 dagen of 7 dagen zonder gebruik, of bij intrekking.

binadit login
binadit accounts list
binadit context use --account 123
binadit whoami

Controleer het bedrijf in whoami voordat je iets wijzigt. Een profiel kiest je verbinding en omgeving; het bedrijf blijft een expliciete context.

Dagelijkse commando’s

Gebruik --help bij een commando voor de precieze parameters van je geïnstalleerde versie. De endpointreferentie beschrijft de mogelijkheden van de server.

binadit dns records list example.com --account 123
binadit workspace accounts list --workspace 12 --account 123
binadit billing invoices list --status open --account 123
binadit capabilities --account 123
binadit completion zsh

Adressen, openbare DNS en domeinextensies

Deze leesopdrachten gebruiken dezelfde opzoekdiensten als het portal. Postcode-opzoeken vraagt account:read, openbare MX-opzoeking spam:read en de extensiecatalogus products:read. MX-resultaten bevatten hostnamen en prioriteiten; het portal verbindt niet met die mailservers. De catalogus laat interne inkoopkosten weg en gebruikt cursorpaginering; featured geeft dezelfde geordende top-50-selectie als registratie. Controleer active en enabled samen; de orderofferte bevestigt de actuele beschikbaarheid.

binadit api /lookups/addresses/1234AB --account 123
binadit api /lookups/mx/example.nl --account 123
binadit api /catalog/domain-extensions --account 123
binadit api /catalog/domain-extensions/featured --account 123

Bekijk wijzigingen vooraf

Gebruik --dry-run waar dat ondersteund wordt. Een lokale --yes bevestigt alleen de CLI-prompt; die omzeilt geen bedrijfsrechten, betaalvoorwaarden of verificatie op de server. Gebruik --wait om geaccepteerd werk tot een definitief resultaat te volgen.

binadit dns records create example.com \
  --type TXT --name _verification --value example \
  --account 123 --dry-run

Workspace-documenten en Book

Een installatie-PDF bevat standaard geen wachtwoord. Bewaar documenten en afbeeldingen in een nieuw privaat bestand; bestaande bestanden worden nooit overschreven. Book-upload en verwijderen vragen workspace:write en de Workspace-versie uit book theme. DNS-export vraagt ook workspace:write omdat deze eigendomsverificatierecords kan bevatten.

binadit workspace accounts setup pdf 7 --workspace 3 --file setup.pdf --account 123
binadit workspace book theme --workspace 3 --account 123
binadit workspace book download logo --workspace 3 --file logo.png --account 123
binadit workspace domains dns export 9 --workspace 3 --format bind --file workspace.bind --account 123

Een PDF met wachtwoord vraagt daarnaast workspace.credentials:read, ingeschakelde gevoelige acties en sterke menselijke verificatie van maximaal 5 minuten oud. De eenmalige claim verloopt na 2 minuten; herhaal het ophalen nooit automatisch na een onduidelijke netwerkfout. Installatie-instructies versturen vraagt workspace.mailboxes:write. Een wachtwoord delen vraagt daarnaast de credential-scope, recente verificatie en de expliciete optie --share-password.

Beoordeel een offerte voordat je bestelt

Bereid één productofferte voor met orders quote, beoordeel de actuele prijzen en geldigheid en bevestig deze daarna afzonderlijk met orders commit. Een offerte bekijken of previewen maakt geen betaalde order. Eén bevestigde offerte is één bestelintentie; afzonderlijke bevestigingen zijn afzonderlijke orders en beloven geen verzamelfactuur.

binadit orders quote --kind workspace_mailbox --from-file mailbox.json --account 123
binadit orders quote get QUOTE_ID --account 123
binadit orders commit QUOTE_ID --account 123

Voor workspace_mailbox bevat mailbox.json workspace_id, domain_id, product_id, local_part en optioneel display_name. Kies actuele bedrijfsresources en een toegestaan pakket uit de API. Een optioneel wachtwoord komt uitsluitend uit een beschermd bestand of stdin.

Webhooks

Stel een ontvanger voor bedrijfsbrede statusmeldingen in met een beschermd JSON-bestand. De CLI reserveert een nieuw privaat sleutelbestand voordat de gepauzeerde webhook wordt aangemaakt. Configureer eerst de ontvanger, lees de actuele versie en schakel daarna in. Een bestaand doelbestand wordt nooit overschreven.

binadit webhooks create --from-file receiver.json --file webhook-key.txt --account 123
binadit webhooks list --account 123
binadit webhooks update WEBHOOK_ID --set enabled=true --version VERSION --account 123
binadit webhooks deliveries WEBHOOK_ID --account 123

Gebruik in scripts

Gebruik een expliciet gekozen account en profiel, JSON-uitvoer en --no-input. Bewaar machinecredentials in je secretmanager. Een geplande taak hoort een eigen integratie te hebben in plaats van een persoonlijke CLI-sessie.

binadit dns records list example.com \
  --account 123 --profile automation --output json --no-input

Uitvoer en exitcodes

Resultaten gaan naar stdout; voortgang en diagnose naar stderr. Vraag JSON expliciet aan als een ander programma het resultaat leest. Een exitcode ongelijk aan nul vraagt aandacht; bekijk de gestructureerde fout en het request-ID.