Listando vagas

Atenção: é obrigatório que a requisição realizada seja do tipo "Content-type: multipart/form-data".

Headers necessários:

Nome	Valor	Descrição
Authorization	Bearer ......................	Bearer Token para autenticação. Saiba mais aqui.
Content-Type	application/json	Define o tipo de formato de conteúdo que será enviado.

Uma vez que os Headers estejam devidamente configurados, podemos ir ao próximo passo.

Endpoint utilizado para criar vagas:

Endpoint	Método	Link para Teste
/api/v2/vacancies/filter	POST	Loading...

Payload

Definição campo a campo para publicação de vagas na API:

Campo	Obrigatório	Tipo e Opções/Formato	Observações e Exemplos
search	Não	string	Termo para buscar vaga Exemplo: "Desenvolvedor Front-end"
orderBy.field	Não	string `title` `app_total` `created_at`	Ordenação de resultados por tipo de campo.
orderBy.type	Não	string `DESC` `ASC`	Tipo de ordenação de resultados.
created_at.max	Não	string `Y-m-d`	Data máxima para a criação da vaga.
created_at.min	Não	string `Y-m-d`	Data mínima para a criação da vaga.
client_id	Não	int \|NULL	Define qual será o cliente que está associado à vaga, caso exista. A lista de clientes pode ser obtida aqui .
creator_id	Não	int	Define qual será é o criador da vaga. A lista de gestores pode ser obtida aqui .
manager_id	Não	int	Define qual será é o o participante da vaga. A lista de gestores pode ser obtida [aqui] .
location.city	Não	string\|NULL	Define a cidade da vaga. Poderá ser NULL caso não tenha cidade definida, numa vaga remota, por exemplo. Exemplo: "Uberlândia"
location.state	Não	string\|NULL	Define o estado da vaga, em UF. Poderá ser NULL caso não tenha estado definido, numa vaga remota, por exemplo. Exemplo: "MG"
location.country	Não	string\|NULL	Define o país da vaga. Poderá ser NULL caso não tenha país definido, numa vaga remota, por exemplo. Exemplo: "Brasil"

Exemplo de retorno

{
  "message": "Ação realizada com sucesso!",
  "export": {
    "uuid": "8b84d328-dd4b-24e5-6f24-ab2d0e01755e",
    "url": "https://api.recrutei.com.br/exporter/v1/vacancies/8b84d328-dd4b-24e5-6f24-ab2d0e01755e"
  },
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "title": "Desenvolvedor Laravel Senior [MCP Test]",
      "city": null,
      "manager_id": 1,
      "vacancy_status_id": 1,
      "state": null,
      "remote": 1,
      "created_at": "há 5 dias",
      "time_to_hire": null,
      "internal_code": null,
      "from_solicitation": 0,
      "solicitation_workflow_id": null,
      "vacancies_solicitations_id": null,
      "quantity": 1,
      "is_favorite": false,
      "is_inclusive": 0,
      "label": "recrutei",
      "client": null,
      "request_reason": {
        "id": 2,
        "name": "Aumento de quadro"
      },
      "app_total": 10,
      "slug": "1-desenvolvedor-laravel",
      "app_newest": 0,
      "hireds_total": 1,
      "reproveds_total": 0,
      "managers": [
        {
          "id": 1,
          "administrator": 1,
          "owner": 0,
          "photo_filename": "avatar.png",
          "user": {
            "id": 1,
            "name": "John Doe",
            "email": "[email protected]"
          },
          "vacancy_id": 116087,
          "photo_url": "https://url-para-o-avatar.com/avatar.png"
        }
      ],
      "is_ultra": 1,
      "pipe_stages": [
        {
          "id": 1,
          "pipe_id": 1,
          "description": "Candidatos",
          "order": 0,
          "apps_total": 0
        },
        {
          "id": 2,
          "pipe_id": 1,
          "description": "Não preencheram",
          "order": 1,
          "apps_total": 0
        },
        {
          "id": 3,
          "pipe_id": 1,
          "description": "Preencheram as informações",
          "order": 2,
          "apps_total": 0
        },
        {
          "id": 4,
          "pipe_id": 1,
          "description": "Analisados pela Rê",
          "order": 3,
          "apps_total": 2
        },
        {
          "id": 5,
          "pipe_id": 1,
          "description": "Bate Papo Inicial",
          "order": 4,
          "apps_total": 4
        },
        {
          "id": 6,
          "pipe_id": 1,
          "description": "Entrevista Técnica",
          "order": 5,
          "apps_total": 2
        },
        {
          "id": 7,
          "pipe_id": 1,
          "description": "Shortlist",
          "order": 6,
          "apps_total": 2
        },
        {
          "id": 8,
          "pipe_id": 1,
          "description": "Finalistas",
          "order": 7,
          "apps_total": 0
        }
      ],
      "sla_from_now": null,
      "is_sla_overdue": null,
      "is_sla_approaching": null
    }
  ],
  "first_page_url": "https://api.recrutei.com.br/api/v2/vacancies/filter?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "https://api.recrutei.com.br/api/v2/vacancies/filter?page=1",
  "next_page_url": null,
  "path": "https://api.recrutei.com.br/api/v2/vacancies/filter",
  "per_page": "10",
  "prev_page_url": null,
  "to": 1,
  "total": 1
}