Order a domain for a web hosting package

Orders a domain for one web hosting package - registered new or moved to manitu - after the user agreed to the AGB and the order.

Orders a domain for a web hosting package, by its site_id: registered new (transfer false) or moved to manitu from another provider (transfer true, with the auth code if there is one). manitu's support carries the order out and confirms it by e-mail (handled: manual); the domain is not active yet when this answers. A domain beyond those the package includes is charged at the enduser price (manitu_public_domain_tld_getPOST /v1/public/domain/tld/get has the list price; an account may have a special price or another tax). Refused per field when the TLD is not one manitu registers under (tld_not_offered), the name is no domain name (invalid), the domain is at manitu already (domain_exists) or an auth code comes without a transfer (not_for_type); with a conflict when the account may not order (order_not_allowed, with reason_list) or the package cannot be changed now (not_configurable). Made with a session of the customer panel, the call is carried out at once; otherwise it waits until a person signed in to the customer panel approves it (approval_required; its state: manitu_approval_getPOST /v1/approval/get).

WWriteNot idempotentNeeds service_webhosting

Counts against: writes (60 per hour per account)

Tool
manitu_webhosting_domain_orderon https://mcp.manitu.de/mcp
POST
/v1/webhosting/domain/orderon https://api.manitu.de
Try it
Changes the account. Agents say what will happen and wait for an explicit yes before calling it.
This request changes something.
readOnlyHint falsedestructiveHint falseidempotentHint falseopenWorldHint false

Orders a domain for a web hosting package, by its site_id: registered new (transfer false) or moved to manitu from another provider (transfer true, with the auth code if the user has it). manitu's support carries the order out and confirms it to the user by e-mail (handled: manual) - it is not active yet when this answers. A domain more than the package includes is charged as manitu lists it with a web hosting package (enduser price; manitu_public_domain_tld_getPOST /v1/public/domain/tld/get has the list price, and an account may have a special price or another tax - the approval names the price that is billed, with the tax of the account's invoice). Waits for the user's approval in the customer panel: the call is answered with approval_required and a pending_action, its approval holding as elements the AGB as a document with a link, the order as a text and what it costs as a price - nothing is ordered until the user approves it there. Refused per field when the TLD is not one manitu registers under (tld_not_offered), the name is no domain name (invalid), the domain is at manitu already (domain_exists) or an auth code comes without a transfer (not_for_type); with a conflict when the account may not order (order_not_allowed, with reason_list) or the package cannot be changed now (not_configurable).

site_id (required)integer | string

The site_id of the package. Never guess one.

pattern ^[1-9][0-9]*$min 1
domain (required)string

The domain, e.g. example.de - with international characters or in ASCII.

min length 3max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
transfer (required)boolean

true: the domain exists at another provider and moves to manitu; false: it is registered new.

authcodestringwrite-only

With transfer only: the auth code (also called EPP or transfer code) the old provider gave the user - leave it out if he does not have it yet (then: manitu_domain_transfer_in_authcode_setPOST /v1/domain/transfer/in/authcode/set).

min length 1max length 255
setup_default_pageboolean

Whether the website of the domain gets manitu's default page. Default true.

approval_tokenstringwrite-only

The token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.

min length 1max length 255
The tool list tells the model a little more about some of these fields, at the end of their description. Programs over REST do not get these hints.
site_idinteger

The package.

domainstring

The domain ordered, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
transferboolean

Whether it moves to manitu (true) or is registered new (false).

handledstring

manual: manitu's support carries the order out and confirms it by e-mail.

One of manual

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

site_id (required)integer | string

The site_id of the package.

pattern ^[1-9][0-9]*$min 1
domain (required)string

The domain, e.g. example.de - with international characters or in ASCII.

min length 3max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
transfer (required)boolean

true: the domain exists at another provider and moves to manitu; false: it is registered new.

authcodestringwrite-only

With transfer only: the auth code (also called EPP or transfer code) the old provider gave the user - leave it out if he does not have it yet (then: manitu_domain_transfer_in_authcode_setPOST /v1/domain/transfer/in/authcode/set).

min length 1max length 255
setup_default_pageboolean

Whether the website of the domain gets manitu's default page. Default true.

approval_tokenstringwrite-only

The token of the way call_again from the approval_required answer of the same call - only after the user said yes to everything in its elements. Valid 15 minutes, once.

min length 1max length 255
site_idinteger

The package.

domainstring

The domain ordered, with international characters.

max length 253pattern ^[^\x00-,./:-@[-`{-\x7F]+(?:\.[^\x00-,./:-@[-`{-\x7F]+)+$
transferboolean

Whether it moves to manitu (true) or is registered new (false).

handledstring

manual: manitu's support carries the order out and confirms it by e-mail.

One of manual
200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.429Too many calls. The Retry-After header says when to try again.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.
Example