Get Top Locations By Operating System

type Cloudflare = {

  token: string;

  email: string;

  key: string;

};

/**

 * Get Top Locations By Operating System

 * Get the top locations, by HTTP traffic, of the requested operating systems. Values are a percentage out of the total traffic.

 */

export async function main(

  auth: Cloudflare,

  os:

    | "WINDOWS"

    | "MACOSX"

    | "IOS"

    | "ANDROID"

    | "CHROMEOS"

    | "LINUX"

    | "SMART_TV",

  limit: string | undefined,

  name: string | undefined,

  dateRange: string | undefined,

  dateStart: string | undefined,

  dateEnd: string | undefined,

  asn: string | undefined,

  location: string | undefined,

  botClass: string | undefined,

  deviceType: string | undefined,

  httpProtocol: string | undefined,

  httpVersion: string | undefined,

  ipVersion: string | undefined,

  tlsVersion: string | undefined,

  format: "JSON" | "CSV" | undefined

) {

  const url = new URL(

    `https://api.cloudflare.com/client/v4/radar/http/top/locations/os/${os}`

  );

  for (const [k, v] of [

    ["limit", limit],

    ["name", name],

    ["dateRange", dateRange],

    ["dateStart", dateStart],

    ["dateEnd", dateEnd],

    ["asn", asn],

    ["location", location],

    ["botClass", botClass],

    ["deviceType", deviceType],

    ["httpProtocol", httpProtocol],

    ["httpVersion", httpVersion],

    ["ipVersion", ipVersion],

    ["tlsVersion", tlsVersion],

    ["format", format],

  ]) {

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

}