Get file JSON

//native

type Figma = {

  token: string;

};

/**

 * Get file JSON

 * Returns the document identified by `file_key` as a JSON object. The file key can be parsed from any Figma file url: `https://www.figma.com/file/{file_key}/{title}`.

The `document` property contains a node of type `DOCUMENT`.

The `components` property contains a mapping from node IDs to component metadata. This is to help you determine which components each instance comes from.

 */

export async function main(

  auth: Figma,

  file_key: string,

  version: string | undefined,

  ids: string | undefined,

  depth: string | undefined,

  geometry: string | undefined,

  plugin_data: string | undefined,

  branch_data: string | undefined,

) {

  const url = new URL(`https://api.figma.com/v1/files/${file_key}`);

  for (const [k, v] of [

    ["version", version],

    ["ids", ids],

    ["depth", depth],

    ["geometry", geometry],

    ["plugin_data", plugin_data],

    ["branch_data", branch_data],

  ]) {

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

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}