redirect

type Client ¶

type Client struct {
	// contains filtered or unexported fields
}

Client wraps the api.Client for the /redirect endpoints.

func New(c *api.Client) *Client

func (s *Client) ListRedirects(ctx context.Context, request ListRedirectsRequest) (response ListRedirectsResponse, err error)

type ListRedirectsRequest ¶

type ListRedirectsRequest struct {
	SortBy     string
	SortDir    string
	PageSize   int
	PageNumber int
}

ListRedirectsRequest paginates / sorts the redirect listing. All fields are optional.

type ListRedirectsResponse ¶

type ListRedirectsResponse struct {
	Return map[string]map[string]Rule `json:"return"`
	models.APIResponse
}

ListRedirectsResponse is the return from /redirect/list_redirects.json.

**Wire-shape quirk** (verified live, May 2026): when the account has redirects, "return" is a nested map keyed by domain → source URL → Rule:

{
  "example.kiwi.nz": {
    "a.example.kiwi.nz": {"destination": "https://...", "type": 301},
    "b.example.kiwi.nz/blog": {"destination": "https://...", "type": 302}
  }
}

When the account has **zero** redirects, "return" is the JSON array `[]`, not the empty object `{}`. The docs only show the populated form, so consumers parsing the obvious map shape would fail on empty accounts.

Custom UnmarshalJSON handles both: the empty array is decoded as an empty map; the populated map is decoded normally.

func (r *ListRedirectsResponse) UnmarshalJSON(data []byte) error

type Rule ¶

type Rule struct {
	Destination string `json:"destination"`
	Type        int    `json:"type"`
}

Rule describes one redirect: where the source URL points to and the HTTP status code (typically 301 or 302).