CVDW API

Uma massa de dados para você chamar de seu.

📈 Introdução

O CVDW é um bulk de dados que foi desenvolvido para simplificar o seu acesso aos dados do CV, essa solução disponibiliza APIs que possibilitam integração com diversas plataformas, como Power BI, Google Looker Studio, MySQL e outras. Com ela, é possível gerenciar as tabelas utilizadas e obter informações em tempo real sobre os dados da incorporadora.

Em nossa Referência de API's existe uma categoria exclusiva para o CVDW


💭Dúvidas Frequentes sobre o CVDW

🚦É necessário atualizar a base de dados com a carga completa de todas as tabelas a cada atualização?

Após carregar todos os dados na sua base, é possível seguir apenas com atualizações dos registros. Para isso, pode-se utilizar o parâmetro a_partir_data_referencia, que retornará apenas os registros criados ou atualizados a partir da data informada. Dessa forma, a primeira carga será completa, e, posteriormente, trabalharemos apenas com atualizações e novos cadastros.

🚦O retorno da consulta está exibindo apenas 30 registros por página. Isso é o comportamento esperado?

É possível ajustar o limite para até 500 registros por página utilizando o parâmetro registros_por_pagina. No entanto, o padrão é de 30 registros por página.

🚦Como não exceder o limite de requisições ?

Sabendo que as APIs do CVDW têm o limite de 20 requisições por minuto, é possível implementar um intervalo entre as requisições para respeitar essa restrição.

Por exemplo:

Ao configurar um intervalo de 3 segundos entre cada requisição, conseguimos realizar exatamente 20 requisições dentro de um minuto, garantindo que o limite estabelecido pela API não seja excedido.



⚙️Conectando com o Power BI

Conectar uma API web no Power BI é uma tarefa relativamente simples e útil para integrar dados externos diretamente em relatórios e painéis interativos. Vamos dividir o processo em etapas detalhadas:

1. Abrir o Power BI Desktop

Inicie o Power BI Desktop.
No menu superior, clique em "Obter Dado de outra Fonte" e selecione "Web"

2. Configurar a Conexão

No modo avançado, você pode configurar uma solicitação HTTP mais completa:

3. Permissão e Conclusão

Para que a consulta ocorre com sucesso é preciso liberar o uso anônimo, caso não seja liberado irá ocorrer erro na conexão.


Exemplo de erro de conexão devido à ausência de permissão para acesso anônimo:


💡Dica

Caso a tela abaixo não apareça, ocorre, pois, há alguma permissão que foi inclusa previamente.


Para ajustar basta ir no Power Query em "Configurações da fonte de dados" e limpar as permissões.


📽️Conectando o Power BI na pratica.