Integração DWV (1.0.1)
Esta documentação descreve o funcionamento da API que a DWV desenvolveu para os integradores externos. Através da nossa API, os sistemas externos podem interagir com a nossa base de imóveis e demais informações disponibilizadas pela DWV.
O atual uso da API é para integração de sites e de integradores para com construtoras (CRMs), e o escopo do uso deve sempre respeitar os termos do contrato estabelecidos entre a DWV e a sua empresa.
Todas as rotas dessa API se utilizam da autenticação com um token. Este token é fornecido pela construtora, onde para a mesma conseguir esse token, deve acessar o sistema de Integração DWV e gerar o token para o sistema de integração desejado.
Para os que ainda não estão familiarizados com este tipo de autenticação, você deve inserir no header de sua requisição um parâmetro chamado token com o valor do token gerado. Um exemplo de como ficaria uma requisição pode ser visualizado abaixo.
curl -H "token: 59bf9b316bf82ec07f5f3447e46adc9be6e9ffd7d1ab5422c41fa693ea29d8dd" \
"https://apisandbox.dwvapp.com.br/"
Listar todos os empreendimentos da construtora
Authorizations:
token
path Parameters
| page | integer Página atual dos dados |
| limit | integer Quantidade de itens por página |
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": [
- {
- "id": 1022,
- "title": "Green Coast",
- "logo": {
- "sizes": {
}
}, - "cover": {
- "sizes": {
}
}, - "address": {
- "id": 407,
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil",
- "street_name": "Rua 248",
- "number": "D 1",
- "neighborhood_name": "Centro",
- "neighborhood": {
- "name": "Centro",
- "id": 2442
}, - "complement": "S/ Complemento",
- "postal_code": "88220-000",
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}
}
}, - {
- "id": 1023,
- "title": "Empire Coast",
- "logo": {
- "sizes": {
}
}, - "cover": {
- "sizes": {
}
}, - "address": {
- "id": 422,
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil",
- "street_name": "Rua 248",
- "number": "D 1",
- "neighborhood_name": "Centro",
- "neighborhood": {
- "name": "Centro",
- "id": 3429
}, - "complement": "S/ Complemento",
- "postal_code": "88220-000",
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}
}
}
], - "lastPage": 1,
- "page": 1,
- "perPage": 10,
- "total": 2
}
Exibir detalhes de um empreendimento
Traz mais detalhes a respeito do empreendimento, trazendo junto consigo as unidades que o mesmo possui.
Authorizations:
token
path Parameters
| re_development_id required | integer ID do empreendimento que você quer obter mais detalhes |
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": {
- "id": 1022,
- "title": "Green Coast",
- "logo": {
- "sizes": {
}
}, - "cover": {
- "sizes": {
}
}, - "address": {
- "id": 406,
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil",
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}, - "complement": "S/ Complemento",
- "latitude": -27.096,
- "longitude": -48.616,
- "neighborhood": {
- "name": "Centro",
- "id": 4237
}, - "neighborhood_name": "Centro",
- "number": "40",
- "postal_code": "88220-000",
- "street_name": "Rua 248"
}, - "units": [
- {
- "id": 405,
- "additional_features": "Cozinha com churrasqueira",
- "administration_fee": "50.0",
- "area_type": "central",
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "garage_area": "11.3",
- "garages": 2,
- "is_rent": false,
- "name": "103",
- "price": "1038.762199",
- "private_area": "45.5",
- "rental_price": null,
- "status": "available",
- "suites": 2,
- "total_area": "51.2",
- "section": {
- "id": 1,
- "name": "Bloco 01",
- "description": "Bloco 01",
- "display_order": 1
}, - "floorplan": {
- "id": 1,
- "name": "Planta Tipo",
- "category": "apartment",
- "display_order": 1
}
}, - {
- "id": 8948,
- "additional_features": "Cozinha com churrasqueira",
- "administration_fee": "50.0",
- "area_type": "central",
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "garage_area": "11.3",
- "garages": 2,
- "is_rent": true,
- "name": "104",
- "price": null,
- "private_area": "45.5",
- "rental_price": "1500.00",
- "status": "available",
- "suites": 2,
- "total_area": "51.2",
- "section": {
- "id": 1,
- "name": "Bloco 01",
- "description": "Bloco 01",
- "display_order": 1
}, - "floorplan": {
- "id": 1,
- "name": "Planta Tipo",
- "category": "apartment",
- "display_order": 1
}
}
], - "features": [
- {
- "tag": "elevator",
- "title": "Elevador"
}
], - "files": {
- "sizes": {
}
}, - "blueprints": {
- "sizes": {
}
}, - "progress_pictures": {
- "sizes": {
}
}, - "linktree": {
- "title": "Linktree"
}
}
}
Exibir todas as unidades de um empreendimento
Traz detalhes prévios de todas as unidades de um empreendimento
Authorizations:
token
path Parameters
| re_development_id required | integer ID do empreendimento para obter todas as suas unidades |
| page | integer Página atual dos dados |
| limit | integer Quantidade de itens por página |
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": [
- {
- "id": 1022,
- "additional_features": "Cozinha com churrasqueira",
- "administration_fee": "50.0",
- "area_type": "central",
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "garage_area": 11.3,
- "garages": 2,
- "is_rent": false,
- "name": "103",
- "price": "1038.762199",
- "private_area": "45.5",
- "rental_price": null,
- "status": "available",
- "suites": 2,
- "total_area": "51.2",
- "section": {
- "id": 1,
- "name": "Bloco 01",
- "description": "Bloco 01",
- "display_order": 1
}, - "floorplan": {
- "id": 1,
- "name": "Planta Tipo",
- "category": "apartment",
- "display_order": 1
}
}, - {
- "id": 1023,
- "additional_features": "Cozinha com churrasqueira",
- "administration_fee": "50.0",
- "area_type": "central",
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "garage_area": 11.3,
- "garages": 2,
- "is_rent": true,
- "name": "10",
- "price": null,
- "private_area": "45.5",
- "rental_price": "1500.00",
- "status": "available",
- "suites": 2,
- "total_area": "51.2",
- "section": {
- "id": 1,
- "name": "Bloco 01",
- "description": "Bloco 01",
- "display_order": 1
}, - "floorplan": {
- "id": 1,
- "name": "Planta Tipo",
- "category": "apartment",
- "display_order": 1
}
}
], - "lastPage": 1,
- "page": 1,
- "perPage": 10,
- "total": 2
}Exibir detalhes de uma unidade
Traz mais detalhes a respeito da unidade selecionada
Authorizations:
token
path Parameters
| re_development_id required | integer ID do empreendimento que está relacionado a unidade que você quer obter mais detalhes |
| property_id required | integer ID da unidade que você quer obter mais detalhes |
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": {
- "id": 1022,
- "additional_features": "Cozinha com churrasqueira",
- "administration_fee": "50.0",
- "area_type": "central",
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "garage_area": 11.3,
- "garages": 2,
- "is_rent": false,
- "name": "103",
- "price": "1038.762199",
- "private_area": "45.5",
- "rental_price": null,
- "status": "available",
- "suites": 2,
- "total_area": "51.2",
- "section": {
- "id": 1,
- "name": "Bloco 01",
- "description": "Bloco 01",
- "display_order": 1
}, - "floorplan": {
- "id": 1,
- "name": "Planta Tipo",
- "category": "apartment",
- "display_order": 1
}
}
}Lista todos os terceiros da construtora
Traz todos os terceiros vinculados a uma construtora
Authorizations:
token
path Parameters
| page | integer Página atual dos dados |
| limit | integer Quantidade de itens por página |
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": [
- {
- "id": 1022,
- "title": "North Shore",
- "subtitle": "Residence",
- "description": "<p>APARTAMENTO</p><ul><li>04 Suítes;</li><li>03 Vagas de garagem;</li><li>Finamente mobiliado;</li><li>Lazer completo;</li></ul>",
- "price": 2000000,
- "address": {
- "id": 465,
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil",
- "street_name": "Rua 129",
- "number": "D 1",
- "neighborhood_name": "Centro",
- "neighborhood": {
- "name": "Centro",
- "id": 2457
}, - "complement": "S/ Complemento",
- "postal_code": "88220-000",
- "latitude": -27.096,
- "longitude": -48.616,
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}
}, - "cover": {
- "sizes": {
}
}
}, - {
- "id": 1023,
- "title": "Privillege",
- "subtitle": "Residence",
- "description": "<p>APARTAMENTO</p><ul><li>04 Suítes;</li><li>03 Vagas de garagem;</li><li>Finamente mobiliado;</li><li>Lazer completo;</li></ul>",
- "price": 3300100,
- "address": {
- "id": 465,
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil",
- "street_name": "Rua 129",
- "number": "D 1",
- "neighborhood_name": "Centro",
- "neighborhood": {
- "name": "Centro",
- "id": 2457
}, - "complement": "S/ Complemento",
- "postal_code": "88220-000",
- "latitude": -27.096,
- "longitude": -48.616,
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}
}, - "cover": {
- "sizes": {
}
}
}
], - "lastPage": 1,
- "page": 1,
- "perPage": 10,
- "total": 2
}
Exibir detalhes de um terceiro da construtora em específico
Traz um terceiro vinculado a uma construtora
Authorizations:
token
Responses
Response samples
- 200
- 401
Content type
application/json
{- "data": {
- "id": 1022,
- "additional_features": "Cozinha com churrasqueira",
- "address": {
- "address_text": "Rua 248 - Meia Praia, Itapema - SC, Brasil,",
- "city": {
- "name": "Itapema",
- "uf": "SC",
- "full_name": "Itapema",
- "area_code": 47,
- "id": 702
}, - "complement": "S/ Complemento",
- "id": 406,
- "latitude": -27.096,
- "longitude": -48.616,
- "neighborhood": {
- "name": "Centro",
- "id": 4237
}, - "neighborhood_name": "Centro",
- "number": "40",
- "postal_code": "88220-000",
- "street_name": "Rua 248"
}, - "administration_fee": "50.0",
- "area_type": "central_area",
- "bathrooms": 2,
- "bedrooms": 2,
- "category": "apartment",
- "display_order": 1,
- "features": [
- {
- "tag": {
- "tag": "elevator",
- "title": "Elevador"
}
}
], - "files": [
- {
- "sizes": {
},
}
], - "garage_area": "11.3",
- "garages": 2,
- "internal_description": "Finamente mobiliado",
- "is_rent": false,
- "name": "103",
- "name_composition": "103",
- "price": "1038.762199",
- "private_area": "45.5",
- "rental_price": null,
- "status": "available",
- "suites": 2,
- "total_area": "51.2"
}
}