Consultas
Endereços
Seção intitulada “Endereços”| 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ções de consulta
Seção intitulada “Opções de consulta”| 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.
Filtros
Seção intitulada “Filtros”- Comparação:
eq,ne,gt,ge,lt,le. - Lógica:
and,or,note 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,neinclusive; para mantê-la, someor 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-31Paginação
Seção intitulada “Paginação”- 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$orderbyou$skip, as páginas ficam mais lentas à medida que avançam.
Valores
Seção intitulada “Valores”- 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.