Dúvida sobre GET /lotecobv
cryptographix opened this issue · comments
Estamos com dúvidas sobre o esquema do retorno da consulta aos lotecobv, pois pela documentação, o endpoint /lotecobv
deve retornar uma lista dos lotes que satisfazem o filtro, sendo que cada lote retornado deve conter lista dos cobvs que lhe pertente.
-
Está correta essa definição? É isso o comportamento esperado?
-
Qual a semântica esperada para a paginação? Entendemos que o chamador sempre determina a quantidade de itens por página
itensPorPagina
na requisição (com default 100) e que, emboraitensPorPagina
também seja devolvido no retorno da requisição, este deve ser sempre igual ao valor enviado pelo cliente .. correto? E que deve ser retornado sempre aquele número de itens, a não ser que seja a última página.
Por exemplo, se o cliente indicar páginas de 100 itens (o default), não temos como retornar apenas itens 0..49, pois a próxima consulta do cliente virá com page=1 => itens 100 em diante.
Voltando para lotecobv, a priori, entendemos ser a nível de objetos "lotecobv", até porque não podemos retornar objetos JSON incompletos. O problema é que, por nossos cálculos, uma página de, por exemplo, 100 lotes com uma quantidade razoável (1000) de cobvs em cada lote, é capaz de estourar alguns limites de rede (hoje temos limites em torno de 4-8MB por pacote, imposto por um gateway de APIs). No entanto, se proceder o entendimento sobre o tamanho da página sendo definido pelo chamador, não temos como informarr que retornamos uma quantia de lotes[] diferente disso.