By Time

type Cloudflare = {

  token: string;

  email: string;

  key: string;

};

/**

 * By Time

 * Retrieves a list of aggregate metrics grouped by time interval.

See [Analytics API properties](https://developers.cloudflare.com/dns/reference/analytics-api-properties/) for detailed information about the available query parameters.

 */

export async function main(

  auth: Cloudflare,

  identifier: string,

  account_identifier: string,

  metrics: string | undefined,

  dimensions: string | undefined,

  since: string | undefined,

  until: string | undefined,

  limit: string | undefined,

  sort: string | undefined,

  filters: string | undefined,

  time_delta:

    | "all"

    | "auto"

    | "year"

    | "quarter"

    | "month"

    | "week"

    | "day"

    | "hour"

    | "dekaminute"

    | "minute"

    | undefined

) {

  const url = new URL(

    `https://api.cloudflare.com/client/v4/accounts/${account_identifier}/dns_firewall/${identifier}/dns_analytics/report/bytime`

  );

  for (const [k, v] of [

    ["metrics", metrics],

    ["dimensions", dimensions],

    ["since", since],

    ["until", until],

    ["limit", limit],

    ["sort", sort],

    ["filters", filters],

    ["time_delta", time_delta],

  ]) {

    if (v !== undefined && v !== "") {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      "X-AUTH-EMAIL": auth.email,

      "X-AUTH-KEY": auth.key,

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}