Criar Proprietário

Nessa rota você pode criar um novo proprietário.

POST https://api.imobiliary.com/owners

Nota:

Esta rota requer autenticação. Você deve fornecer o cabeçalho Authorization com um token de autenticação válido. O token deve ser obtido através da rota de autenticação.

Requisição

Para realizar essa requisição, deve-se fornecer o corpo da requisição no seguinte formato.

{
  "fullname": "Ciclano de Tal",
  "cpf": "123.456.768-43",
  "rg": "324352-X",
  "email": "ciclanodetal@gmail.com",
  "cellphone": "(17) 32414-2134",
  "occupation": "Desenvolvedor",
  "marital_status": "Solteiro(a)",
  "address": {
    "street": "Rua das Oliveiras",
    "number": "502",
    "complement": "",
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "15000-000"
  }
}

Respostas

Esses são as possíveis respostas desta requisição.

201

Receberá essa resposta caso forneça um corpo da requisição válido.

HTTP/1.1 201 Created
Location: /owners/aaf6f6fc-f049-4930-898f-30499cf103fa

400

Receberá essa resposta caso não forneça o corpo da requisição ou informe algum dos campos de forma incorreta. Exemplo:

{
  "fullname": "Ciclano de Tal",
  // sem o campo cpf
  "rg": "324352-X",
  "email": "ciclanodetal@gmail.com",
  "cellphone": "(17) 32414-2134",
  "occupation": "Desenvolvedor",
  "marital_status": "Solteiro(a)",
  "address": {
    "street": "Rua das Oliveiras",
    "number": "502",
    "complement": "",
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "15000-000"
  }
}

Resposta:

{
  "status": "Bad Request",
  "code": 400,
  "result": {
    "code": 400,
    "message": "cpf do proprietário não pode ser vazio",
    "error": "Bad Request"
  }
}

401

Receberá essa resposta caso não envie o token de autenticação no cabecalho Authorization, caso o token enviado não seja válido ou tenha expirado.

{
  "status": "Unauthorized",
  "code": 401,
  "result": {
    "code": 401,
    "message": "token inválido ou expirado",
    "error": "Unauthorized"
  }
}

409

Receberá essa resposta caso o corpo da requisição conflite com dados de cpf, rg, email ou address já existentes.

{
  "status": "Conflict",
  "code": 409,
  "result": {
    "code": 409,
    "message": "proprietário já existe",
    "error": "Conflict"
  }
}

500

Receberá essa resposta caso ocorra um erro interno no servidor. Isso pode acontecer por diversos motivos, como problemas de conexão com o servidor.

Caso o problema persista Entre em contato

{
  "status": "Internal Server Error",
  "code": 500,
  "result": {
    "code": 500,
    "message": "erro interno do servidor",
    "error": "Internal Server Error"
  }
}