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.
Dienstverlenging en herstel van oorspronkelijke verzoeken
Hosting-abonnementen, Exchange-mailboxen en spamfilters gebruiken in het portaal, de API en de CLI dezelfde opzeggingsprocedure. Opzeggen stopt de verlenging en behoudt de vastgelegde betaalde leveringsperiode. Hervatten verwijdert de oorspronkelijke geplande opzegging binnen die periode. Een afzonderlijke domeinregistratie wordt apart beoordeeld; geen van beide acties verstuurt een bevestigingsmail.
Lees eerst de exacte dienst. Controleer het huidige bedrijf, de betaald-tot-datum en ETag. Bevestig één oorspronkelijke intentie-UUID en bewaar die samen met het HTTP-bewerkings-ID en de UUID van het opzeggingsbewijs. Het actuele bedrijfslidmaatschap, de modulerechten, identiteitsgeneratie en toepasselijke inlogverificatie worden bij de werkelijke boekhoudkundige grens opnieuw gecontroleerd. Gewone serviceverbindingen behouden hun bestaande afgebakende toegang; interne portaalbeheerders hebben actuele passkey-goedkeuring nodig.
WeFact hervat een abonnement door TerminationDate te wissen. Die bewerking zet de factuurteller van de leverancier op nul. Automatisch hervatten ondersteunt daarom alleen een expliciet geverifieerde onbeperkte afspraak (TerminateAfter=0) met ongewijzigd leveranciers-ID, debiteur, valuta, begindatum, periode, aantal en prijs. Eindige of ontbrekende limieten vereisen afstemming vóór hervatten; een booleaan in een verzoek kan geen afwijkende toekomstige financiële voorwaarden goedkeuren.
API
Gebruik deze resourcepaden onder /api/v1/accounts/{account}:
| Dienst | Resourcepad | Recht |
|---|---|---|
| Hosting | hosting/subscriptions/{id} |
hosting:write |
| Exchange | exchange/mailboxes/{id} |
exchange:write |
| Spam | spam/filters/{id} |
spam:write |
POST {resource}/actions/cancel en POST {resource}/actions/resume accepteren {"intent_id":"<original UUID>"} plus Idempotency-Key en If-Match. Bij weglaten wordt de serverbewerkings-UUID de bedrijfsintentie. Met een expliciete UUID kun je diezelfde bedrijfsintentie na een verloren antwoord opzoeken, ook als de client zijn oorspronkelijke HTTP-sleutel kwijt is. Een andere HTTP-sleutel met dezelfde bedrijfs-UUID retourneert het oorspronkelijke bewijs en de oorspronkelijke resourceweergave; er wordt niet opnieuw verstuurd.
Het antwoord behoudt de bestaande dienstvelden en voegt cancellation toe, inclusief cancellation_intent_id, intent_id, het oorspronkelijke operation_id, resource_type, resource_id, action, state, billing_confirmed en requires_reconciliation. De ingesloten resource is het oorspronkelijke resultaat, geen nieuwe weergave na latere wijzigingen. Lees de dienst vóór een andere actie opnieuw voor zijn actuele ETag.
Een proefuitvoering controleert lokale rechten, versie, resource, openstaande bestellingen en facturatie zonder een bewerking toe te wijzen, een journaal voor te bereiden of een leverancier te benaderen. Zij meldt supplier_checks_performed:false: werkelijke externe commerciële velden worden alleen vóór een echte indiening geverifieerd.
Herstel
Maak na een time-out, transportfout of onzekere uitkomst geen nieuwe intentie aan en herhaal het boekhoudkundige verzoek niet.
GET {resource}/cancellations?limit=25toont de oorspronkelijke bewijzen voor deze verbinding. Volg de begrensde UUIDnext_cursorom verdere pagina's te bekijken.GET {resource}/cancellations/{receipt}leest het ondertekende oorspronkelijke lokale bewijs zonder leveranciersaanroep.- Expliciet
POST {resource}/cancellations/{receipt}/actions/reconcilegebruikt een nieuwe HTTP-idempotentiesleutel voor die terugleesactie. Deze leest alleen het oorspronkelijke leveranciersabonnement en verstuurt nooit nog een beëindigings-/hervattingsverzoek. Actuele rechten en de oorspronkelijke bedrijfs-/identiteitsbinding zijn vereist. Een servicekoppeling moet zijn oorspronkelijke aanvragende identiteit behouden. Een vernieuwde persoonlijke verbinding van dezelfde mens en identiteitsgeneratie mag de oorspronkelijke bewijzen bekijken. Geef voor afstemming via die nieuwe verbindingconfirm_intent_idgelijk aan de oorspronkelijke bedrijfs-UUID,confirm_resource_id, de actueleIf-Matchen recente sterke authenticatie op. Dit keurt uitsluitend teruglezen/lokaal afronden goed; de oorspronkelijke journaalidentiteit blijft ongewijzigd en geen leverancierswijziging wordt herhaald.
Gewijzigde identiteitsgeneraties of een andere oorspronkelijke menselijke gebruiker vereisen afzonderlijk geautoriseerd beheerderherstel buiten deze endpoints. Houd de oorspronkelijke intentie geblokkeerd totdat dat herstel beschikbaar is; bewerk nooit de journaal-/facturatierijen en dien geen vervangende boekhoudkundige wijziging in.
De boekhoudkundige intentie en exact gevraagde beëindigingsdatum worden vóór verzending vastgelegd. Een ontvangen bevestiging blijft onafhankelijk van latere lokale publicatie bewaard. Teruglezen kan de oorspronkelijke lokale resource/referentie/bewerking atomair afronden, ook nadat de oorspronkelijke kalendergrens is verstreken. Een hard beëindigd proces laat zijn blijvende markering achter en kan geen tweede automatische verzending veroorzaken.
prepared betekent dat alleen een oorspronkelijk bewijs bekend is; controleer dat voordat je iets beslist. requires_reconciliation betekent dat boekhoudkundige bevestiging ontbreekt. completed bevestigt de oorspronkelijke boekhoudkundige/lokale uitkomst. not_submitted bewijst dat deze voorbereiding niet heeft verstuurd: lees na controle de actuele dienst en beoordeel expliciet een nieuwe intentie. Een openstaande volledige bestelling, onafgeronde levering, onduidelijke/vreemde facturatiespiegel, onbekende abonnementsstatus of niet-beoordeelde geïmporteerde facturatie blijft geblokkeerd in plaats van een onterechte opzegging te melden.
CLI
binadit exchange mailboxes get 73 --account 12
binadit exchange mailboxes renewal cancel 73 --account 12 --version <etag> --confirm-resource 73 --intent-id <uuid> --yes
binadit exchange mailboxes renewal list 73 --account 12
binadit exchange mailboxes renewal get 73 <receipt-uuid> --account 12
binadit exchange mailboxes renewal reconcile 73 <receipt-uuid> --account 12 --yes
# After a new personal login, explicit renewed approval for readback:
binadit exchange mailboxes renewal reconcile 73 <receipt-uuid> --account 12 --version <current-etag> --confirm-resource 73 --confirm-intent <original-uuid> --yes
binadit exchange mailboxes renewal resume 73 --account 12 --version <new-etag> --confirm-resource 73 --intent-id <new-uuid> --yes
Dezelfde renewal-opdrachten bestaan onder hosting subscriptions en spam filters. Wijzigingsuitvoer is beperkt tot geverifieerde bewijsmetadata. Geen opdracht herhaalt automatisch een onzekere boekhoudkundige wijziging of verandert door herhaald opvragen in een nieuwe actie. Behandel een CLI-time-out niet als annulering van de oorspronkelijke poging.
Portaal en agents
De dienstregel opent een expliciete beoordeling met zijn vastgezette versie. Bevestig eenmaal. Het bewijs blijft zichtbaar; een onzeker antwoord biedt controle van het oorspronkelijke bewijs en expliciet teruglezen, zonder automatische POST-herhaling. Interne beheerders kunnen passkey-bewijs vernieuwen en de dienst daarna opnieuw beoordelen. Lees de actuele dienst voordat je een andere wijziging begint.
Agents moeten de bedrijfscontext, het getypeerde dienst-ID, de oorspronkelijke intentie-UUID, HTTP-bewerking en het bewijs behouden. Ze mogen nooit een ongerelateerde domeinbestelling met hetzelfde numerieke ID vervangen, één geblokkeerd onderdeel uit een onafgeronde volledige bestelling opzeggen, financieel succes uit een transportfout afleiden, automatisch het terugzetten van een eindige facturatieteller goedkeuren of een onzekere wijziging met een nieuwe datum reconstrueren. Deze endpoints omvatten momenteel verlenging van Hosting, Exchange en Spam; domein-/Workspace-eigendom en andere opzeggingsonderdelen behouden hun afzonderlijke gedocumenteerde procedures totdat ze expliciet zijn gemigreerd.
Een afgerond antwoord vereist ook dat de bedoelde lokale dienststatus, opzeggingsreferentie en het oorspronkelijke bewijs zijn opgeslagen en teruggelezen. Een geannuleerde of gewijzigde lokale schrijfactie behoudt de geaccepteerde boekhoudkundige bevestiging voor expliciete uitsluitend lezende afstemming. Dat herstel verstuurt nooit nog een beëindigings- of hervattingsverzoek. Een eindbewijs dat tijdens vastleggen verandert, wordt als onbevestigd gemeld; bewaar de oorspronkelijke intentie en controleer het bewijs voordat je een andere actie onderneemt.