HostFact API versie 3.1
Hosting
Hostingaccounts zijn te beheren via de controller 'hosting'.
updowngrade
Met behulp van deze functie is het mogelijk om een hosting account te up- of downgraden.
Voorbeeldbestand: /voorbeelden/hosting/hosting.updowngrade.php
Invoerparameters:
Veldnaam | Waarde | Omschrijving |
---|---|---|
Identifier | int | De unieke ID van een hosting account |
Username | string | De accountnaam (en gebruikersnaam) |
Product | int | De unieke ID van het nieuwe product waar naar geupgrade wordt |
ProductCode | int | Het productnummer van het nieuwe product waar naar geupgrade wordt |
Periods | int | Factureer iedere: aantal periodes. Standaard: huidig abonnement |
Periodic | string | Factureer iedere: eenheid, zie variabelen-lijst. Standaard: huidig abonnement |
InvoiceCycle | 'existing_period' of 'new_period' |
Bepaalt de financiële afhandeling Standaard: voorkeursinstelling existing_period: De periode tot het volgende facturatiemoment wordt gefactureerd. Daarna zal pas een volledige periode worden gefactureerd. new_period: Er wordt direct een volledige (nieuwe) periode gefactureerd. De resterende periode van het vorige abonnement zal in mindering worden gebracht. |
CreateInvoice | 'yes' of 'no' | Dient er direct een factuur aangemaakt te worden? Standaard: voorkeursinstelling |
Voorbeeld invoer:
<?php require_once("../hostfact_api.php"); $api = new HostFactAPI(); $hostingParams = array( 'Username' => 'activeaccount', 'ProductCode' => 'P002', 'Periods' => 1, 'Periodic' => 'm', 'InvoiceCycle' => 'new_period', 'CreateInvoice' => 'yes' ); $response = $api->sendRequest('hosting', 'updowngrade', $hostingParams); print_r_pre($response); ?>
Voorbeeld uitvoer:
Array ( [controller] => hosting [action] => updowngrade [status] => success [date] => 2022-11-24T12:00:00+02:00 [success] => Array ( [0] => Factuur [concept]0001 is bewerkt [1] => Up-/downgrade van hostingaccount activeaccount is doorgevoerd in HostFact en op de server. ) [hosting] => Array ( [Identifier] => 3 [Username] => activeaccount [Debtor] => 1 [DebtorCode] => DB0001 [Domain] => activedomain.com [Server] => 1 [Package] => 1 [PackageName] => Hosting small [Comment] => [Status] => 4 [Created] => 2022-11-24 11:00:00 [Modified] => 2022-11-24 11:00:00 [Subscription] => Array ( [Number] => 1 [NumberSuffix] => [ProductCode] => P002 [Description] => Hosting small [PriceExcl] => 25 [PriceIncl] => 30.25 [TaxPercentage] => 21 [DiscountPercentage] => 0 [Periods] => 1 [Periodic] => m [StartPeriod] => 2022-12-24 [EndPeriod] => 2023-01-24 [NextDate] => 2022-12-10 [ContractPeriods] => 1 [ContractPeriodic] => m [StartContract] => 2022-11-24 [EndContract] => 2022-12-24 [TerminationDate] => [Reminder] => [InvoiceAuthorisation] => yes [AmountExcl] => 25 [AmountIncl] => 30.25 ) [PackageInfo] => Array ( [Identifier] => 1 [Name] => Hosting small [Type] => normal [Template] => yes [TemplateName] => [BandWidth] => [DiscSpace] => [Domains] => [SubDomains] => [Domainpointers] => [MySQLDatabases] => [EmailAccounts] => ) [ServerInfo] => Array ( [Identifier] => 1 [Name] => Example server [Panel] => hostingclass [Location] => https://localhost [Port] => 1234 [IP] => [AdditionalIP] => [Settings] => [DefaultDNSTemplate] => 1 [SSOSupport] => url ) [Translations] => Array ( [Status] => Actief ) ) )