Buscar Proprietário

Nessa rota você pode buscar um proprietário cadastrado pelo proprietário autenticado, através do id.

GET https://api.imobiliary.com/owners/:owner_id

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 informar um id de proprietário válido e que tenha sido cadastrado por você, para assim trazer seus dados. Exemplo:

GET https://api.imobiliary.com/owners/aaf6f6fc-f049-4930-898f-30499cf103fa

Respostas

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

200

Receberá essa resposta caso informe um id de proprietário existente e que tenha sido cadastrado por você.

{
  "status": "OK",
  "code": 200,
  "result": {
    "id": "aaf6f6fc-f049-4930-898f-30499cf103fa",
    "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)",
    "manager_id": "0fabb50f-d83b-4c77-a2c9-c62bfecfac1c",
    "address": {
      "mini_address": "Rua das Oliveiras, 502, Centro, São Paulo/SP",
      "street": "Rua das Oliveiras",
      "number": "502",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zip_code": "15000-000",
    },
  }
}

400

Receberá essa resposta caso informe um id de proprietário invalido.

{
  "status": "Bad Request",
  "code": 400,
  "result": {
    "code": 400,
    "message": "id do recurso inválido",
    "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"
  }
}

403

Receberá essa resposta caso informe um id de proprietário que não foi cadastrado por você.

{
  "status": "Forbidden",
  "code": 403,
  "result": {
    "code": 403,
    "message": "acesso negado a este recurso",
    "error": "Forbidden"
  }
}

404

Receberá essa resposta caso informe um id de proprietário que não existe.

Nota:

Caso não informe o id de um proprietário, será devolvida uma resposta sem o formato padrão de erro.

{
  "status": "Not Found",
  "code": 404,
  "result": {
    "code": 404,
    "message": "proprietário não encontrado ou não existente",
    "error": "Not Found"
  }
}

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"
  }
}