Faixa de preço De: até

Lista de comparação

Facilite seu desenvolvimento

Nossos recursos vão ajudar você não somente a automatizar seu processo como também melhorar tudo que você pode fazer dentro do LarJá. Saiba que sempre estamos melhorando mais e mais, você só precisa utilizar nossas ferramentas para facilitar seu trabalho e obter resultados rapidamente.

Primeiramente, faça a autenticação

A autenticação é a chave que fará com que você possa trabalhar com nossa API, veja em seguida como realizar a autenticação.

Utilizando o protocolo OAuth 2.0

Como conseguir a autorização? Através do Protocolo OAuth 2.0, um dos mais utilizados em plataformas abertas (Twitter, Facebook, etc.) e método seguro para trabalhar com recursos privados.

Primeiramente nossa equipe registra uma aplicação para você no larja.com.br, depois sua aplicação precisará solicitar uma chave de acesso ao servidor de autenticação e então utilizar essa chave para receber e enviar informações em um recurso da API.

Antes de iniciar o protocolo de autenticação com o servidor larja.com.br, o cliente deverá fornecer os seguintes dados: Nome do clientewebsitetelefone e email, em seguida registramos sua aplicação que ficará com status integration.

Autenticação e Autorização

A plataforma do LarJá permite trabalhar com recursos públicos e privados da API através de chamadas HTTP com os verbos GET, PUT, POST, DELETE e OPTIONS.

O acesso a recursos públicos podem ser feito de forma anônima, mas os recursos privados e as ações próprias dos usuários como anunciar um imóvel, precisam de autorização mediante um aplicativo.

Por isso explicaremos o significado de autenticação e o fluxo de autorização que deve ser aplicado para ter um access_token (senha de acesso a recursos privados por cada usuário que o aplicativo autorizar).

Autorização

Após registrarmos sua aplicação e liberamos uma identificação (client_id e client_secret), com ele já será possível dar início a sequência de autorização. A sequência de autorização tem início quando a aplicação redireciona o navegador para uma URL do larja.com.br. O LarJá é o responsável pela autenticação do usuário e por confirmar a permissão de acesso a suas informações e recursos. Como resultado, o larja.com.br retorna para a aplicação um código de autorização. Após receber o código de autorização a aplicação poderá fornecê-­lo para obter em troca uma chave de acesso (access_token). A aplicação poderá então utilizar essa chave de acesso para acessar a API.

Autenticação

Autenticação é o ato ou processo para o estabelecimento ou confirmação de algo ou alguém como real.
O servidor de autenticação valida a requisição para certificar que todos os parâmetros obrigatórios estão válidos e presentes. Se a requisição for válida o servidor de autenticação tenta autenticar o usuário (pedindo seu login e senha) e obtém dele uma decisão de autorização, após autenticar o usuário com seu login e senha,  o usuário é redirecionado ao cliente junto com o código de autorização.

Este código deverá ser utilizado logo em seguida para solicitar a chave de acesso que permitirá o cliente a acessar suas informações através da API.

A URL usada para autenticar um usuário será http://larja.com.br/oauth/authorize

Como parâmetros devem ser enviados a URL acima o client_id e redirect_uri, sendo que o client_id é uma das identificações fornecidas pelo larja.com.br através do registro da aplicação e redirect_uri é a URL de redirecionamento definida por você.

Veja um exemplo da URL completa para autorização: http://larja.com.br/oauth/authorize?response_type=code&client_id=NJoK0Z22IKaUnBOIDd8Vqc2bGamycYNZHbKIbNKT&redirect_uri=dominio.com

A resposta será enviada para o redirect_uri, conforme especificado na URL da requisição. Se o usuário aprovar o acesso, a resposta conterá um código de autorização, a respostas é retornada ao servidor web por query string.

O Código de autorização (code) gerado pelo servidor de autenticação será então utilizado para solicitar permissão de acesso a recursos de um usuário, ele expira 10 minutos após ter sido gerado e não pode ser reutilizado.

Exemplo de resposta de confirmação: http://dominio.com?code=MsCeLvI4gaQm6bTrgtp7P7q7W91a­oMsCeLvI

Chave de acesso

Chaves de acesso são credenciais usadas para acessar recursos protegidos de um usuário. É uma string que representa uma autorização emitida ao cliente. Esta chave representa permissões específicas, concedidas pelo usuário e emitida pelo servidor de autorização.

Requisição da chave de acesso

A URL usada para solicitar a chave de acesso será http://larja.com.br/oauth/token, após receber o código de autorização no passo anterior, o cliente poderá trocá-lo por uma chave de acesso (access_token) através de uma nova requisição. Esta requisição deverá ser um post e conter os seguintes parâmetros: client_id, client_secret, grant_type com valor authorization_code, code e redirect_uri.

Se a solicitação da chave de acesso for válida e autorizada, o servidor de autenticação retorna um HTTP 200 (OK) com valor da chave de acesso. Se a solicitação falhar o servidor de autenticação retorna um erro.

O servidor de autenticação gera uma chave de acesso e constrói a resposta adicionando os seguinte parâmetros no corpo da resposta, veja o exemplo abaixo.

{“access_token”:”pcblzakiji6lifajaqemhs6sys5rvir7j18nkzzsh”,”expires_in”:86400,”token_type”:”Bearer”, “scope”:”basic”,”refresh_token”:”jujbopvarykg3yvp38lma3edcaguigfkpbafknol”,”created”:1499262926}

Depois que sua a aplicação obtiver a chave de acesso (access_token) poderá então utilizar a API larja.com.br para acessar recursos privados de um determinado usuário.

Requisição para importação de um anúncio

Chegou a hora de importar seu primeiro anúncio, o processo de importação de anúncios consiste em um POST no formato JSON descrevendo um anúncio para inclusão ou exclusão. Nosso servidor faz a validação das informações presentes e retorna um JSON como resposta.

A URL usada para fazer o envio do anúncio é: http://larja.com.br/wp-json/wp/v2/property, o nosso servidor deve receber a requisição com método do tipo POST e você deve sempre informar uma action (add_property ou update_property), no caso de update_property deve-se obrigatoriamente informar a ID do imóvel no LarJá.

Transações suportados pela API:

  • Locação
  • Venda

Tipos de Imóveis suportados pela API:

  • Apartamento
  • Casa
  • Chácara
  • Cobertura
  • Fazenda
  • Flat – Apart Hotel
  • Galpão/Depósito/Armazém
  • Kitnet
  • Loja Comercial
  • Sala Comercial
  • Sítio
  • Sobrado
  • Terreno/Lote

Características de Imóveis suportados pela API:

  • Academia
  • Ar condicionado
  • Área de serviço
  • Churrasqueira
  • Condomínio fechado
  • Edícula
  • Elevador
  • Garagem
  • Jardim
  • Lavanderia
  • Mobiliado
  • Piscina
  • Salão de festas
  • Sauna
  • Segurança 24h
  • Sistema de TV
  • WiFi

Plantas e Unidades API:
O Recurso de Plantas e Unidades não esta disponível por API até o momento.

Definição de atributos

É necessário saber que, ao criar um JSON para seu anúncio, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão automaticamente adicionados pelo LarJá. Eles definirão o modo como o produto será exibido e sua posição nos resultados da busca.

Outro detalhe é que até aqui, seus imóveis não serão exibidos na área pública do portal, pois eles irão ficar com status draft (já que sua aplicação esta com status integration), você poderá conferir os dados do anúncio após logar no portal com seu usuário e senha e indo no menu rascunho, depois que você tiver certeza de que sua integração esta funcional, alteramos o status da sua aplicação para production.

Agora você já está pronto para publicar seu primeiro item. Você pode criar um JSON para seu imóvel com base no exemplo abaixo, basta você substituir access_token pelo seu.

{
	"access_token":"RsT5OjbzRn430zqMLgV3Ia",
	"post_type":"property",
	"action":"add_property",
	"property_id":"AP0001",
	"prop_id":0,
	"prop_type":"Apartamento",
	"prop_transaction":"Locação",
	"prop_price":2000,
	"prop_title":"Apartamento para venda no centro de Pato Branco",
	"prop_des":"Ótima localização, em frente a praça Presidente Vargas!",
	"prop_size":100,
	"prop_land_area":0,
	"prop_beds":3,
	"prop_baths":3,
	"prop_garage":1,
	"prop_garage_size":25,
	"prop_year_built":2017,
	"additional_features":[
		{
			"fave_additional_feature_title":"Suítes",
			"fave_additional_feature_value":1
		},
		{
			"fave_additional_feature_title":"IPTU",
			"fave_additional_feature_value":"350"
		},
		{
			"fave_additional_feature_title":"Desconto de Pontualidade",
			"fave_additional_feature_value":"200"
		}
	],
	"prop_features":[
		"Lareira",
		"Churrasqueira",
		"Elevador",
		"Piscina",
		"Salão de festas"
	],
	"prop_address":"Rua Guarani, Centro de Pato Branco",
	"prop_map_address":"R. Guarani - Centro, Pato Branco - PR, 85501-270",
	"prop_province":"Paraná",
	"prop_locality":"Pato Branco",
	"prop_neighborhood":"Centro",
	"prop_postal_code":"85501-270",
	"prop_google_street_view":"show",
	"prop_map_lat":"-26.2242664",
	"prop_map_lng":"-52.7073744",
	"prop_map_zoom":"13",
	"virtual_tour":"https://goo.gl/maps/hXnsVKYxKNv",
	"prop_video_url":"https://www.youtube.com/watch?v=hv4Gyj38LGM",
	"prop_images":[
		{
			"url":"http://larja.s3.amazonaws.com/wp-content/uploads/2017/07/DSC_2546.jpg", 
			"description":"Sala"
		},
		{
			"url":"http://larja.s3.amazonaws.com/wp-content/uploads/2017/07/DSC_2556.jpg", 
			"description":"Sala"
		},
		{
			"url":"http://larja.s3.amazonaws.com/wp-content/uploads/2017/07/DSC_2570.jpg", 
			"description":"Sala"
		},
		{
			"url":"http://larja.s3.amazonaws.com/wp-content/uploads/2017/07/DSC_2582.jpg", 
			"description":"Sala"
		},
		{
			"url":"http://larja.s3.amazonaws.com/wp-content/uploads/2017/07/DSC_2589.jpg", 
			"description":"Estritório"
		}
	]
}

Exemplode retorno

{
    "ID": 35931,
    "post_author": "17",
    "post_date": "2017-07-05 22:47:40",
    "post_date_gmt": "2017-07-06 01:47:40",
    "post_content": "Ótima localização, em frente a praça Presidente Vargas!",
    "post_title": "Apartamento para venda no centro de Pato Branco",
    "post_excerpt": "",
    "post_status": "pending",
    "comment_status": "closed",
    "ping_status": "closed",
    "post_password": "",
    "post_name": "35931-apartamento-venda-pato-branco-bairro-centro-3-quartos-1-vaga-de-garagem",
    "to_ping": "",
    "pinged": "",
    "post_modified": "2017-07-05 22:47:40",
    "post_modified_gmt": "2017-07-06 01:47:40",
    "post_content_filtered": "",
    "post_parent": 0,
    "guid": "https://larja.com.br/imovel/apartamento-venda-pato-branco-bairro-centro-3-quartos-1-vaga-de-garagem/",
    "menu_order": 0,
    "post_type": "property",
    "post_mime_type": "",
    "comment_count": "0",
    "filter": "raw"
}

Parabéns! Você publicou seu primeiro anúncio!
Se você experimentar algum inconveniente ao tentar publicar, por favor deixe-nos saber e entramos em contato com você.