Find file for shared link

//native

type Box = {

  token: string;

};

/**

 * Find file for shared link

 * Returns the file represented by a shared link.

A shared file can be represented by a shared link,

which can originate within the current enterprise or within another.

This endpoint allows an application to retrieve information about a

shared file when only given a shared link.

The `shared_link_permission_options` array field can be returned

by requesting it in the `fields` query parameter.

 */

export async function main(

  auth: Box,

  fields: string | undefined,

  if_none_match: string,

  boxapi: string,

) {

  const url = new URL(`https://api.box.com/2.0/shared_items`);

  for (const [k, v] of [["fields", fields]]) {

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

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      "if-none-match": if_none_match,

      boxapi: boxapi,

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

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

  }

  return await response.json();

}