API recrutadores

Visão Geral

A API de recrutadores disponibiliza operações referentes a usuários/representantes de uma empresa. A parte pública dessa API disponibiliza apenas uma operação no momento, que é a criação de recrutador.


Operações

CRUD Métodos HTTP
Create POST

Criando/cadastrando um recrutador

curl -H 'Content-type: Content-Type: application/json' -H  'app-token: XYZ' \
     -X POST --url 'http://api.catho.com.br/ats/v1/recruiters' \
     -d @/tmp/payload.json

O corpo do POST (apontado no exemplo acima como o arquivo /tmp/payload.json) é algo como:

{
  "cnpj": "",
  "usuario": {
    "nome": "José Silva",
    "email": "jose.silva@catho.com",
    "cpf": "00000000000",
    "telefone": "(00) 00000-0000",
    "genero": "M"
  }
}

Se a operação foi bem sucedida, o código de status HTTP retornado será um 201 com o o corpo:

{
    "login": "xyz...",
    "senha": "zyx..."
}

No caso de falha, os erros possíveis podem ser vistos na seção a seguir.


Erros

Algum erro pode ocorrer durante a tentativa de cadastro de recrutador.
Abaixo está uma lista de código e mensagem dos que podem ocorrer.

Código Mensagem
REC000 Erro ao validar JSON. A estrutura está correta?
REC001 Campo CNPJ é obrigatório
REC002 Nome do usuário é obrigatório
REC003 E-mail é obrigatório
REC004 CPF é obrigatório
REC005 Cargo é obrigatório
REC006 Telefone é obrigatório
REC007 *
REC008 Valor pra o campo sexo deve ser 'M' ou 'F'

* mensagem de erro dinâmica


Endpoints

No momento temos somente uma URL base, como abaixo:

Produção: http://api.catho.com.br/ats/v1/