bacen / pix-api

API Pix: a API do Arranjo de Pagamentos Instantâneos Brasileiro, Pix, criado pelo Banco Central do Brasil.

Home Page:https://bacen.github.io/pix-api

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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.

  1. Está correta essa definição? É isso o comportamento esperado?

  2. 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, embora itensPorPagina 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.