Estrutura padrão

Agora que você já fez sua primeira consulta, vamos explorar a estrutura padrão das requisições enviadas à Plataforma de Dados da BigDataCorp.

As consultas da Plataforma de Dados seguem uma estrutura padronizada, utilizada em todas as APIs da BigDataCorp.

Nesta seção, você aprenderá:

Como organizar corretamente os parâmetros no corpo da requisição.

O papel de cada parâmetro na construção da consulta.

Como montar consultas consistentes e reutilizáveis.

Como utilizar o padrão adotado em todas as APIs da plataforma.


Esses conceitos formam a base para a construção de consultas e serão fundamentais para compreender os próximos tópicos da documentação, incluindo parâmetros de consulta, chaves de identificação, personalização de retorno e recursos adicionais.


Ao concluir esta seção, você terá uma visão completa da estrutura base das consultas realizadas na Plataforma de Dados.



1️⃣ Estrutura básica da requisição

As APIs da Plataforma de Dados utilizam o método POST, e recebem, no corpo da requisição, três parâmetros principais:

  • q – chaves de busca (obrigatório)
  • Datasets – datasets desejados no retorno (obrigatório)
  • Limit – limite máximo de entidades retornadas (opcional)

{
  "q": "doc{12345678900}",
  "Datasets": "basic_data"
}

ℹ️

Essa estrutura é compartilhada por todas as APIs da Plataforma de Dados, incluindo Pessoas, Empresas, Endereços, Processos, Veículos e demais entidades disponíveis.