Start
/
API-Referenz
/
API-Dokumentation (XML/ JSON)
/
Auftragstypen
/
Redirect-Auftragstypen

Redirect Update

API-Referenz (XML/JSON) · Aktualisiert 2023-09-07

Funktion

Der Auftragstyp RedirectUpdate aktualisiert die Daten einer Weiterleitung. Es können beispielsweise Zieladresse (target), Modus (mode) oder die Backup-Zieladressen (backup) geändert werden.

Beschreibung

Die Struktur für RedirectUpdate gleicht der von RedirectCreate. Bei der Aktualisierung nicht geändert werden dürfen die Werte "source" und "type". Der Wert "type" kann nicht geändert werden, da URLs normalerweise keine gültigen E-Mail-Adressen sind und E-Mail-Adressen in der Regel keine gültigen URLs.

Route: PUT /redirect/{source]

{
    "source": "example.com",
    "target": "example-target.com/test",
    "type": "DOMAIN",
    "mode": "HTTP"
}

{
    "stid": "20190701-app2-dev-15314",
    "status": {
        "code": "S0502",
        "text": "Weiterleitung wurde erfolgreich aktualisiert.",
        "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.com/test",
            "type": "DOMAIN",
            "mode": "HTTP",
            "domain": "example.com"
        }
    }
}

Auftragstyp-Code: 0502
Verwendet Objekt Redirect

Domain redirect update

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0502</code>
		<redirect>
			<type>domain</type>
			<mode>frame</mode>
			<title>New title</title>
			<source>www.source-example.com</source>
			<target>www.target-domain.de/somewhere</target>
			<backup>www.target-example-backup.com/somewhere/else</backup>
		</redirect>
	</task>
</request>

<response>
	<result>
		<status>
			<code>S0502</code>
			<text>Weiterleitung wurde erfolgreich aktualisiert.</text>
			<type>success</type>
		</status>
	</result>
</response>

Email redirect update (single)

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0502</code>
		<redirect>
			<type>email</type>
			<mode>single</mode>
			<source>source@email-address.de</source>
			<target>new_target@email-address.net</target>
		</redirect>
	</task>
</request>

<response>
	<result>
		<status>
			<code>S0502</code>
			<text>Weiterleitung wurde erfolgreich aktualisiert.</text>
			<type>success</type>
		</status>
	</result>
</response>