Zum Inhalt springen

Web-Weiterleitungen

Zuletzt aktualisiert am

Web-Weiterleitungen leiten Besucher Ihrer Domain zu einer anderen Ziel-URL weiter.

Sie rufen eine Liste aller konfigurierten Web-Weiterleitungen für eine bestimmte DNS-Zone ab. Dieser Endpunkt liefert Details zu den eingerichteten Weiterleitungen, einschließlich der internen IDs, die für spätere Aktualisierungen oder Löschungen erforderlich sind.

URL: GET /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/web-forwards

Beispielantwort (200 OK):

[
{
"dnsWebForwardId": "1197eb24-059e-4252-9b22-eae96645435f",
"source": "@",
"sourcePath": "/altes-verzeichnis",
"target": "[https://stackit.de/neu](https://stackit.de/neu)",
"via": "permanent",
"keepPath": false
},
{
"dnsWebForwardId": "2298fb35-060f-5363-ac33-fbf07756546g",
"source": "blog",
"target": "[https://mein-blog-extern.de](https://mein-blog-extern.de)",
"via": "frame",
"keepPath": false
}
]

Sie erstellen eine neue Web-Weiterleitung für eine bestimmte Zone. Der Dienst unterstützt permanente Weiterleitungen (301) und Frame-Weiterleitungen (Maskierung).

URL: POST /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/web-forwards

Anfrage-Body:

{
"source": "shop",
"target": "https://mein-externer-shop.de/produkte",
"via": "permanent",
"keepPath": true
}

Sie aktualisieren eine bestehende Weiterleitung, um beispielsweise ein neues Ziel festzulegen.

URL: PATCH /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/web-forwards/{dnsWebForwardId}

Sie entfernen eine bestimmte Web-Weiterleitung dauerhaft aus einer DNS-Zone. Dieser Aufruf löscht die Weiterleitung und bereinigt automatisch die zugehörigen, vom System verwalteten DNS-Einträge (provider locks).

URL: DELETE /api/v1/organizations/{organizationId}/dns-zones/{dnsZoneId}/web-forwards/{dnsWebForwardId}

Antwort (Erfolgreich gelöscht):

204 No Content