Listar todas as Páginas de Divulgação

A InHire expõe um endpoint público (sem autenticação) que retorna a página de carreira default do tenant junto com todas as vagas publicadas: Obter Página de Carreira — GET /job-posts/public/pages.

Header obrigatório

A requisição precisa enviar o cabeçalho X-Tenant com o identificador do tenant. Para obter o X-Tenant, copie o início do link do app — em tenant.inhire.app, o valor é tenant.

Custom Fields da Vaga

A página de divulgação em si não possui campos personalizados, mas as vagas associadas possuem. Use o parâmetro de query opcional customFieldIds para incluir campos personalizados específicos das vagas no retorno.

Formato esperado:

?customFieldIds={customField1},{customField2}

Exemplo:

https://api.inhire.app/job-posts/public/pages?customFieldIds=customField1,customField2

Obter uma página específica

Para obter os dados de uma página de divulgação individual a partir do ID, use Obter uma Página de Divulgação — GET /job-posts/public/pages/{id}.

Exemplo de uso em TypeScript

Como o endpoint é público, não é necessário obter token de acesso.

const INHIRE_API_URL = "https://api.inhire.app";
const TENANT_ID = "{{tenantId}}";

async function getCareerPage(customFieldIds?: string[]) {
  const url = new URL(`${INHIRE_API_URL}/job-posts/public/pages`);
  if (customFieldIds && customFieldIds.length > 0) {
    url.searchParams.set("customFieldIds", customFieldIds.join(","));
  }

  const response = await fetch(url.toString(), {
    method: "GET",
    headers: {
      "X-Tenant": TENANT_ID,
    },
  });

  return response.json();
}

async function main() {
  const careerPage = await getCareerPage();
  console.log(careerPage);
}

main();