List Custom Report Column Labels

//native

type Personio = {

	clientId: string

	clientSecret: string

}

/**

 * List Custom Report Column Labels

 * This endpoint provides human-readable labels for report table columns. It is particularly important if you get a report with custom attributes or absence data to match the column IDs to the translation.

 */

export async function main(

	auth: Personio,

	columns: string | undefined,

	locale: string | undefined,

	report_id: string | undefined,

	X_Personio_Partner_ID?: string,

	X_Personio_App_ID?: string

) {

	const url = new URL(`https://api.personio.de/v1/company/custom-reports/columns`)

	for (const [k, v] of [

		['columns', columns],

		['locale', locale],

		['report_id', report_id]

	]) {

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

			url.searchParams.append(k, v)

		}

	}

	const response = await fetch(url, {

		method: 'GET',

		headers: {

			...(X_Personio_Partner_ID ? { 'X-Personio-Partner-ID': X_Personio_Partner_ID } : {}),

			...(X_Personio_App_ID ? { 'X-Personio-App-ID': X_Personio_App_ID } : {}),

			Authorization: 'Bearer ' + (await getOAuthToken(auth, 'https://api.personio.de/oauth2/token'))

		},

		body: undefined

	})

	if (!response.ok) {

		const text = await response.text()

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

	}

	return await response.json()

}

async function getOAuthToken(auth: Personio, tokenUrl: string): Promise<string> {

	const params = new URLSearchParams({

		grant_type: 'client_credentials',

		client_id: auth.clientId,

		client_secret: auth.clientSecret

	})

	const response = await fetch(tokenUrl, {

		method: 'POST',

		headers: {

			Authorization: 'Basic ' + btoa(`${auth.clientId}:${auth.clientSecret}`),

			'Content-Type': 'application/x-www-form-urlencoded'

		},

		body: params.toString()

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`OAuth token request failed: ${response.status} ${text}`)

	}

	const data = await response.json()

	return data.access_token

}