Get analytics by time

type Cloudflare = {

  token: string;

  email: string;

  key: string;

};

/**

 * Get analytics by time

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

 */

export async function main(

  auth: Cloudflare,

  zone: string,

  dimensions: string | undefined,

  sort: string | undefined,

  until: string | undefined,

  metrics: string | undefined,

  filters: string | undefined,

  since: string | undefined,

  time_delta:

    | "year"

    | "quarter"

    | "month"

    | "week"

    | "day"

    | "hour"

    | "dekaminute"

    | "minute"

    | undefined

) {

  const url = new URL(

    `https://api.cloudflare.com/client/v4/zones/${zone}/spectrum/analytics/events/bytime`

  );

  for (const [k, v] of [

    ["dimensions", dimensions],

    ["sort", sort],

    ["until", until],

    ["metrics", metrics],

    ["filters", filters],

    ["since", since],

    ["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();

}