Pular para o conteúdo

Consultas

Endereço O que traz
/v2/ Documento de serviço: as tabelas que o token pode ler
/v2/$metadata O modelo (CSDL): tipos, chaves e descrição de cada coluna
/v2/<tabela> As linhas da tabela
/v2/<tabela>/$count Quantas linhas, em texto puro
/v2/<tabela>(<chave>) Uma linha pela chave, por exemplo /v2/apontamentos(81234)

Todos os endereços partem de https://platform.agrosti.com.br. O $metadata só mostra as tabelas do escopo do token.

Opção Exemplo
$select $select=controle,data,horas
$filter $filter=data ge 2026-01-01 and eh_campo eq true
$orderby $orderby=data desc
$top $top=100
$skip $skip=100
$count $count=true (o total vem em @odata.count)

Com $select, a chave da tabela vem junto mesmo que não esteja na lista: o Power BI precisa dela para ler as outras colunas. Decimais vêm sempre sem expoente (1000139.08, nunca 1.00013908e+06).

$expand, $apply, $search e $compute respondem 501: relacione e agregue as tabelas no seu modelo.

  • Comparação: eq, ne, gt, ge, lt, le.
  • Lógica: and, or, not e parênteses.
  • Texto: contains(operacao,'Pulver'), startswith(fazenda,'Santa'), endswith(...).
  • Vazio: ordem_servico eq null. Em texto, número e data, uma linha vazia fica fora das outras comparações, ne inclusive; para mantê-la, some or ordem_servico eq null. Texto em branco e código 0 contam como vazios.
  • Verdadeiro/falso: eh_campo eq true, ou só eh_campo.
  • Texto vai entre aspas simples. Para uma aspa dentro do texto, use duas: 'd''água'.

Os filtros valem em qualquer coluna da tabela.

Datas aceitam 2026-01-01 ou 2026-01-01T03:00:00Z, o formato que o Power BI manda na atualização incremental. As datas do sistema estão no horário de Brasília (-03:00): o instante 2026-01-01T03:00:00Z é a meia-noite de 1º de janeiro.

Quando a coluna guarda data e hora, filtrar por um dia pega o dia inteiro.

A tabela inspecoes_mip exige um período no $filter, com início e fim, de no máximo 366 dias:

/v2/inspecoes_mip?$filter=data ge 2026-01-01 and data le 2026-03-31
  • Cada página traz até 5.000 linhas. Para páginas menores, envie Prefer: odata.maxpagesize=1000.
  • Quando há mais linhas, a resposta traz @odata.nextLink. Siga o link como veio, até ele não vir mais.
  • Sem $orderby, as páginas seguem a ordem da chave, o caminho mais rápido. Com $orderby ou $skip, as páginas ficam mais lentas à medida que avançam.
  • Inteiros e decimais chegam como número JSON; datas como "2026-01-31"; horas como "07:30:00".
  • Texto vazio e códigos zerados chegam como null.
  • Datas e horas inválidas no cadastro chegam como null.
  • Se o sistema da sua organização não tem um módulo, as tabelas dele respondem vazias, sem erro.