hosting

POST `/v1/sites/{siteId}/redirects`

Add a redirect to a site.

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/redirects \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "domain": <string>, "path": <string>, "destination": <string> }'

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

Adds one rule. ⛔ The vendor endpoint behind this is a whole-set write, so the engine reads the existing rules, appends, and sends the set back — last writer wins. Two people adding a redirect at the same moment is the one case where one of the two additions is lost, and there is no vendor primitive that would prevent it. destination is checked before anything is written to the customer's .htaccess: a protocol-relative //evil.example/ passes a naive "starts with a slash" test and redirects the site's visitors to somebody else's server, so it is refused 422 here. type is a closed set (301, 302) checked in this layer and in the driver, because the platform types it as a free string and an unreviewed token would be written straight into the file. 404 for a site with no managed hosting package. Requires sites.view and sites.panel_access.

Parametry

Název	Typ	Požadováno	Co to je
`siteId (path)`	`Uuid`	Ano	Site ID (UUIDv7).

Tělo požadavku

Název	Typ	Požadováno	Co to je
`domain`	`string`	Ano	The domain or alias on the package the rule applies to.
`path`	`string`	Ano	The path being redirected. ⛔ Named `path` and never `source` — `source` is a reserved attribute on every serializer field one layer down, and a field of that name silently reads…
`destination`	`string`	Ano	Where the visitor is sent. A protocol-relative value is refused: it hands the customer's visitors to another server while looking like a local path.
`type`	`string<301, 302>`	Ne	The redirect status. `301` is permanent and is cached by browsers and search engines; `302` is temporary. Nothing else is accepted.

Odpověď

Název	Typ	Požadováno	Co to je
`id`	`string`	Ano	⛔ Ours, not the vendor's — this platform mints no identifier for a redirect, so this encodes the domain/type/path triple that addresses one. Opaque, stable across reads, and…
`domain`	`string`	Ano	The domain or alias the rule applies to.
`path`	`string`	Ano	The path being redirected. ⛔ Named `path` and never `source`, which is a reserved attribute one layer down and would silently read the wrong value.
`destination`	`string`	Ano	Where the visitor is sent.
`type`	`string<301, 302>`	Ano	The redirect status — permanent or temporary.

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 409 · 422 · 429 · 503

POST /v1/sites/{siteId}/redirects