Get location data

//native

type Foxentry = {

  apiKey: string;

};

/**

 * Get location data

 * Foxentry allows you to get information about location based on the dataScope option. Country and ID parameters are required. You can either choose internal ID, which is assigned by Foxentry or external ID from the data source. CZ external = RUIAN, PL external = Gov data, SK external does not exist.

 */

export async function main(

  auth: Foxentry,

  api_version: string | undefined,

  foxentry_include_request_details: string | undefined,

  body: {

    request: {

      customId?: string;

      query: { country: string; id: string };

      options?: {

        dataScope?: "basic" | "full";

        dataSource?: string[];

        zipFormat?: false | true;

        countryFormat?:

          | "alpha2"

          | "alpha3"

          | "local"

          | "localShortened"

          | "international"

          | "internationalShortened";

        cityFormat?: "basic" | "minimal" | "extended";

      } & { idType?: "internal" | "external" };

      client?: {

        ip?: string;

        country?: string;

        location?: { lat?: number; lon?: number };

      };

    };

  },

) {

  const url = new URL(`https://api.foxentry.com/location/get`);

  const headers: Record<string, string> = {

    "Content-Type": "application/json",

    Authorization: "Bearer " + auth.apiKey,

  };

  if (api_version) {

    headers["api-version"] = api_version;

  }

  if (foxentry_include_request_details) {

    headers["foxentry-include-request-details"] = foxentry_include_request_details;

  }

  const response = await fetch(url, {

    method: "POST",

    headers,

    body: JSON.stringify(body),

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}