Zum Hauptinhalt springen
POST
/
cms
/
v3
/
url-redirects
Eine Weiterleitung erstellen
curl --request POST \
  --url https://api.hubapi.com/cms/v3/url-redirects/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "<string>",
  "redirectStyle": 123,
  "routePrefix": "<string>",
  "isMatchFullUrl": true,
  "isMatchQueryString": true,
  "isOnlyAfterNotFound": true,
  "isPattern": true,
  "isProtocolAgnostic": true,
  "isTrailingSlashOptional": true,
  "precedence": 123
}
'
{
  "destination": "<string>",
  "id": "<string>",
  "isMatchFullUrl": true,
  "isMatchQueryString": true,
  "isOnlyAfterNotFound": true,
  "isPattern": true,
  "isProtocolAgnostic": true,
  "isTrailingSlashOptional": true,
  "precedence": 123,
  "redirectStyle": 123,
  "routePrefix": "<string>",
  "created": "2023-11-07T05:31:56Z",
  "updated": "2023-11-07T05:31:56Z"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Professional
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Starter

Autorisierungen

​
Authorization
string
header
erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
destination
string
erforderlich

Die Ziel-URL, an die die Target-URL bei einer Übereinstimmung mit „routePrefix“ weitergeleitet wird.

​
redirectStyle
integer<int32>
erforderlich

Der Typ der zu erstellenden Weiterleitung. Mögliche Optionen: 301 (dauerhaft), 302 (temporär) oder 305 (Proxy). Weitere Informationen finden Sie [hier].(https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).

​
routePrefix
string
erforderlich

Die eingehende Ziel-URL, der Pfad oder das Muster für die Weiterleitung.

​
isMatchFullUrl
boolean

Ob „routePrefix“ mit der gesamten URL übereinstimmen soll, einschließlich Domain.

​
isMatchQueryString
boolean

Ob „routePrefix“ mit der gesamten URL übereinstimmen soll, einschließlich Abfragezeichenfolge.

​
isOnlyAfterNotFound
boolean

Ob die URL-Weiterleitungszuordnung nur angewendet werden soll, wenn keine live geschaltete Seite unter der URL gefunden wird. Bei „false“ (falsch) hat die URL-Weiterleitungszuordnung Vorrang vor anderen vorhandenen Seiten.

​
isPattern
boolean

Ob „routePrefix“ mit dem Muster übereinstimmen soll.

​
isProtocolAgnostic
boolean

Ob „routePrefix“ mit dem HTTP- und dem HTTPS-Protokoll übereinstimmen soll.

​
isTrailingSlashOptional
boolean

Ob ein angehängter Schrägstrich ignoriert werden soll.

​
precedence
integer<int32>

Wird verwendet, um die URL-Weiterleitung zu priorisieren. Wenn eine angegebene URL mit mehr als einer Weiterleitung übereinstimmt, wird diejenige mit der niedrigeren Priorität verwendet.

Antwort

successful operation

​
destination
string
erforderlich

Die Ziel-URL, an die die Target-URL bei einer Übereinstimmung mit „routePrefix“ weitergeleitet wird.

​
id
string
erforderlich

Die eindeutige ID dieser URL-Weiterleitung.

​
isMatchFullUrl
boolean
erforderlich

Ob „routePrefix“ mit der gesamten URL übereinstimmen soll, einschließlich Domain.

​
isMatchQueryString
boolean
erforderlich

Ob „routePrefix“ mit der gesamten URL übereinstimmen soll, einschließlich Abfragezeichenfolge.

​
isOnlyAfterNotFound
boolean
erforderlich

Ob die URL-Weiterleitungszuordnung nur angewendet werden soll, wenn keine live geschaltete Seite unter der URL gefunden wird. Bei „false“ (falsch) hat die URL-Weiterleitungszuordnung Vorrang vor anderen vorhandenen Seiten.

​
isPattern
boolean
erforderlich

Ob „routePrefix“ mit dem Muster übereinstimmen soll.

​
isProtocolAgnostic
boolean
erforderlich

Ob „routePrefix“ mit dem HTTP- und dem HTTPS-Protokoll übereinstimmen soll.

​
isTrailingSlashOptional
boolean
erforderlich

Ob ein angehängter Schrägstrich ignoriert werden soll.

​
precedence
integer<int32>
erforderlich

Wird verwendet, um die URL-Weiterleitung zu priorisieren. Wenn eine angegebene URL mit mehr als einer Weiterleitung übereinstimmt, wird diejenige mit der niedrigeren Priorität verwendet.

​
redirectStyle
integer<int32>
erforderlich

Der Typ der zu erstellenden Weiterleitung. Mögliche Optionen: 301 (dauerhaft), 302 (temporär) oder 305 (Proxy). Weitere Informationen finden Sie [hier].(https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).

​
routePrefix
string
erforderlich

Die eingehende Ziel-URL, der Pfad oder das Muster für die Weiterleitung.

​
created
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die URL-Zuordnung ursprünglich erstellt wurde.

​
updated
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die URL-Zuordnung zuletzt geändert wurde.

Last modified on March 24, 2026