Exchange valt buiten deze API/CLI-release. Eventuele historische Exchange-voorbeelden in deze gids zijn niet beschikbaar; dit zegt niets over bestaande portaalfuncties. Zie het actuele releasebereik.
Publieke portaalinstellingen
Interne beheerders kunnen de publieke portaalnaam en het contactadres aanpassen. De naam verschijnt in de paginatitel en voettekst; het contactadres staat in de voettekst. Deze instellingen gelden voor het volledige portaal en alle bedrijven, ook wanneer een beheerder een specifieke bedrijfscontext heeft geselecteerd.
Dit beheer wijzigt geen SMTP-verzendadres, portaal-URL, inlogbeleid, leveranciersverbinding, valuta, btw of facturatie. De overeenkomstige serverinstellingen zijn in het scherm alleen ter informatie zichtbaar. Oude bedrijfsspecifieke configuratieregels, stijl en logo blijven behouden; deze functie bewerkt uitsluitend de bestaande globale naam en het contactadres.
In het portaal
Open Portaalinstellingen, vul de publieke naam en het contactadres in, bevestig dat de wijziging voor alle bedrijven geldt en kies Portaalgegevens opslaan. Bevestig met een recente passkey. De volgende pagina toont de nieuwe gegevens. Er worden geen e-mails verstuurd.
Is het antwoord onderbroken, herlaad het scherm en controleer de werkelijk opgeslagen waarden voordat je opnieuw wijzigt. Het formulier herhaalt een onduidelijke schrijfactie niet automatisch. Wanneer een andere beheerder de instellingen heeft gewijzigd, wordt je verouderde versie geweigerd; beoordeel dan eerst de nieuwe waarden.
CLI
Log in als menselijke interne beheerder. --account selecteert de beheercontext en beperkt deze globale wijziging niet tot dat bedrijf.
binadit admin portal-settings get --account 1
binadit admin portal-settings update --account 1 --version CURRENT_VERSION --confirm-global --from-file branding.json --dry-run
binadit admin portal-settings update --account 1 --version CURRENT_VERSION --confirm-global --from-file branding.json
Vervang CURRENT_VERSION door de version uit get. Het JSON-bestand bevat alleen:
{
"app_name": "Voorbeeldportal",
"contact_email": "help@example.com"
}
Gebruik een privébestand of vertrouwde stdin; op Windows voer je JSON in via --from-file -. Gebruik voor onbemande invoer --yes, maar behoud de expliciete --confirm-global en actuele menselijke beheerdersverificatie. Een automatiseringssleutel krijgt geen toegang tot dit beheer. --dry-run controleert de opdracht zonder instellingen of een wijzigingsbewerking op te slaan.
API
| Methode en pad | Scope | Werking |
|---|---|---|
GET /api/v1/accounts/{context}/admin/portal-settings |
admin:read |
Globale naam, contactadres, scope: global en versie; ETag in de headers |
PUT /api/v1/accounts/{context}/admin/portal-settings |
admin:write |
Exact beoordeelde globale gegevens opslaan |
Beide endpoints vereisen een actuele menselijke interne beheerder met recente passkeyverificatie. Een PUT bevat app_name, contact_email en confirm_global: true, plus optioneel dry_run: true. Stuur de actuele If-Match en een blijvende Idempotency-Key. Een ontbrekende versie geeft 428; een gewijzigde versie 412; ongeldige of niet-ondersteunde velden 422. De wijziging en audit worden atomair opgeslagen. Eén gedeelde databasevergrendeling voorkomt dat twee eerste wijzigingen meerdere globale configuraties aanmaken. Reeds bestaande dubbele globale configuraties geven 409 en vereisen correctie vóór opslaan.
Bij een verloren antwoord bewaar je de oorspronkelijke berichtinhoud en idempotentiesleutel. Lees de opgeslagen gegevens of de oorspronkelijke bewerking. Een herhaling met dezelfde sleutel geeft de oorspronkelijke bevestigde uitkomst; vervang de sleutel niet om een versieconflict te omzeilen.
Instructies voor AI-agents
De globale reikwijdte is een wezenlijke eigenschap: behoud expliciet confirm_global: true en laat zien dat de wijziging ieder bedrijf raakt. Interpreteer --account nooit als een bedrijfsspecifiek doel voor huisstijl. Lees de actuele versie, beoordeel de exacte twee publieke velden en gebruik een oorspronkelijke idempotentiesleutel voor schrijfacties. Controleer bij onzekerheid de actuele instellingen en de oorspronkelijke bewerking in plaats van succes te raden. Breid dit endpoint niet uit met SMTP-, authenticatie-, leveranciers-, betalings- of belastinginstellingen. Plaats nooit sleutels of andere inloggegevens in de publieke naam of het contactveld.