Creating TypeScript Controller Endpoints

TypeScript
export const createEntityController = async (
  body: Namespace.Entity.CreateEntityParams,
): Promise<AxiosResponse<Namespace.Entity.Entity, any>> => {
  const url = '/api/entity/';
  const instance = genRequestInstance();

  try {
    const response = await instance.post(url, body);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};

Example 1: With URL parameter Input: Entity "AdicionalNoturno" with versao parameter Output:

TypeScript
/**
 * Creates a new AdicionalNoturno record
 * @param {Planejamento.Versao.Versao['id']} versao - The version ID
 * @param {Pessoal.Premissas.AdicionalNoturno.CreateAdicionalNoturnoParams} params - The creation parameters
 * @returns {Promise<AxiosResponse<Pessoal.Premissas.AdicionalNoturno.AdicionalNoturno, any>>} The created AdicionalNoturno
 * @throws {Error} When request fails or authentication is invalid
 */
export const createAdicionalNoturnoController = async (
  versao: Planejamento.Versao.Versao['id'],
  params: Pessoal.Premissas.AdicionalNoturno.CreateAdicionalNoturnoParams,
): Promise<AxiosResponse<Pessoal.Premissas.AdicionalNoturno.AdicionalNoturno, any>> => {
  const url = `/api/pessoal/versao/${versao}/adicional-noturno/`;
  const instance = genRequestInstance();

  try {
    const response = await instance.post(url, params);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};

Example 2: Without URL parameters Input: Entity "Area" with no parameters Output:

TypeScript
/**
 * Creates a new Area record
 * @param {Planejamento.Cadastro.Area.CreateAreaParams} body - The area data to create
 * @returns {Promise<AxiosResponse<Planejamento.Cadastro.Area.Area, any>>} The created Area
 * @throws {Error} When request fails or authentication is invalid
 */
export const createAreaController = async (
  body: Planejamento.Cadastro.Area.CreateAreaParams,
): Promise<AxiosResponse<Planejamento.Cadastro.Area.Area, any>> => {
  const url = '/api/planejamento/area/';
  const instance = genRequestInstance();

  try {
    const response = await instance.post(url, body);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};