- Start
- API-Referenz
- API-Dokumentation (XML/ JSON)
- Auftragstypen
- Redirect-Auftragstypen
Redirect Create
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
{
"source": "example.com",
"target": "example-target.com/test",
"type": "DOMAIN",
"mode": "HTTP"
}{
"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>
<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>
<result>
<status>
<code>S0501</code>
<text>Weiterleitung wurde erfolgreich eingetragen.</text>
<type>success</type>
</status>
</result>
</response>Domain redirect, frame mode
<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>
<result>
<status>
<code>S0501</code>
<text>Weiterleitung wurde erfolgreich eingetragen.</text>
<type>success</type>
</status>
</result>
</response>Email redirect single mode
<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>
<result>
<status>
<code>S0501</code>
<text>Weiterleitung wurde erfolgreich eingetragen.</text>
<type>success</type>
</status>
</result>
</response>Email redirect catch-all mode
<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>
<result>
<status>
<code>S0501</code>
<text>Weiterleitung wurde erfolgreich eingetragen.</text>
<type>success</type>
</status>
</result>
</response>