Skip to main content

Redirect

FastGateway supports HTTP redirects to route clients to different URLs without backend processing.

Basic Redirect

Redirect to a different path:

filters:
- type: "RequestRedirect"
requestRedirect:
path:
type: "ReplaceFullPath"
replaceFullPath: "/new-location"
statusCode: 301

Scheme Redirect (HTTP to HTTPS)

Force HTTPS:

filters:
- type: "RequestRedirect"
requestRedirect:
scheme: "https"
statusCode: 301

Host Redirect

Redirect to a different host:

filters:
- type: "RequestRedirect"
requestRedirect:
hostname: "new-domain.com"
statusCode: 302

Full Redirect Example

Combine multiple redirect options:

filters:
- type: "RequestRedirect"
requestRedirect:
scheme: "https"
hostname: "api.example.com"
path:
type: "ReplacePrefixMatch"
replacePrefixMatch: "/v2"
port: 443
statusCode: 308

Status Codes

CodeDescription
301Permanent redirect (cacheable)
302Temporary redirect (not cached)
307Temporary redirect (preserves method)
308Permanent redirect (preserves method)

Use Cases

  • HTTP to HTTPS migration
  • Domain consolidation
  • API version deprecation
  • URL shortening