Skip to main content

​
Envelope

Toda resposta de sucesso:
​
object
O conteúdo da consulta.
​
string[]
Limitações do que veio — indício versus prova, casamento por nome, ausência de valor. São para pessoa ler no log, nunca comando para máquina interpretar.
​
object
atualizadoEm é a carga mais recente que sustenta a resposta. cacheSegundos é quanto você pode guardar sem perguntar de novo.

​
Números vêm com a qualidade colada

A Pandora lê duas bases independentes, mantidas por pipelines separados: um grafo de topologia e uma ontologia relacional. Elas não concordam sempre — medido, a diferença chega a 6% em licitação. Um produto que escolhesse um dos dois em silêncio estaria entregando um número com falsa precisão. A diferença tem forma própria:
12duas fontes43só o grafo
Por isso todo número que pode divergir sai assim:
​
boolean
true quando o campo foi confirmado, false quando as duas bases discordaram. Na discordância você recebe o número do grafo.
​
"ambas" | "grafo" | "ontologia"
ambas é o dado mais forte que temos: duas bases independentes disseram a mesma coisa. ontologia é a única origem de razão social e de valor em reais.
Se você quer só o número, é .contratos.valor. A intenção do formato é que você esbarre em conferido no caminho — uma linha a mais de código, e a diferença entre uma integração que sabe o que manipula e uma que não sabe.
Quando conferido é false: use o valor, não some com outros campos, e não exiba como número exato.

​
Erros

​
404 e 503 não se substituem

404 é uma afirmação sobre o mundo: essa entidade não existe. 503 diz que a consulta não pôde ser feita agora.Se uma base estiver fora do ar você recebe 503 — nunca 404, nunca conectadas: false. A mensagem inclui explicitamente “isto não significa que não exista”, porque uma integração que grava ausência a partir de indisponibilidade cria um dado errado que ninguém revisa depois.
Trate 503 como “tente de novo”, jamais como resultado.