Inhaltsverzeichnis dieser Seite

Funktion

Der Auftragstyp RedirectCreate legt eine neue Weiterleitung für eine Domain oder E-Mail-Adresse an.

Die Weiterleitungen werden über einen eigenen Server vorgenommen (IP-Adresse 62.116.130.8). Parallel zu dem Eintrag in die Weiterleitungs-Verwaltung musst du die Domain und die gewünschten Subdomain-Einträge auf diese IP-Adresse umstellen. Betreibst du eigene Nameserver, musst du die IP-Adresse manuell auf deinen Nameservern eintragen.
Möchtest du nur eine E-Mail-Weiterleitung ohne Web-Weiterleitung einrichten, musst du den MX der Quellen umstellen, damit er auf die IP-Adresse 62.116.130.8 verweist. Bitte ändere hierzu die IP-Adresse der als MX genutzten Subdomain. Beachte bei Domains die Groß- und Kleinschreibung. E-Mail-Adressen werden vom System automatisch in Kleinbuchstaben umgewandelt.

Beispiele

Eine Domain weiterleiten

example.com => example.de
example.com => example.de / subfolder / index.html

E-Mail-Adressen weiterleiten

jane_smith@example.com => jane@example.de (mode=single)
@example.com=> jane@example.de (mode=catchall)

Beschreibung

Route: POST /redirect

Request
{
    "source": "example.com",
    "target": "example-target.com/test",
    "type": "DOMAIN",
    "mode": "HTTP"
}
Response
{
    "stid": "20190701-app2-dev-15314",
    "status": {
        "code": "S0501",
        "text": "Weiterleitung wurde erfolgreich eingetragen.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Redirect",
        "summary": 1
    },
    "object": {
        "type": "Redirect",
        "value": "example.com",
        "data": {
            "created": "2014-10-24T09:43:47.000+0200",
            "updated": "2017-11-17T17:35:21.000+0100",
            "source": "example.com",
            "target": "example-target.de/test",
            "type": "DOMAIN",
            "mode": "HTTP",
            "domain": "example.com"
        }
    }
}

Auftragstyp-Code: 0501
Verwendet Objekt
Redirect

Domain redirect, http-mode

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>domain</type>
			<mode>http</mode>
			<source>www.source-example.com</source>
			<target>www.target-example.com</target>
		</redirect>
	</task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>

Domain redirect, frame mode

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>domain</type>
			<mode>frame</mode>
			<title>Redirection-Title</title>
			<source>www.source-example.com</source>
			<target>www.target-example.com</target>
			<backup>www.backup-target1.de</backup>
			<backup>www.backup-target2.de</backup>
			<backup>www.backup-target3.de</backup>
		</redirect>
	</task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>

Email redirect single mode

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>email</type>
			<mode>single</mode>
			<source>source@email-address.com</source>
			<target>target@email-address.com</target>
		</redirect>
	</task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>

Email redirect catch-all mode

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0501</code>
		<redirect>
			<type>email</type>
			<mode>catchall</mode>
			<source>@email-address.com</source>
			<target>target@email-address.com</target>
		</redirect>
	</task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0501</code>
			<text>Weiterleitung wurde erfolgreich eingetragen.</text>
			<type>success</type>
		</status>
	</result>
</response>