...
II. 30 chamadas ao mês, para endpoint classificados como de média frequência
III. 120 chamadas ao mês, para endpoint classificado como de média-alta frequência
IV. 240 chamadas ao mês, para endpoint classificado como de alta frequência
IVV. 420 chamadas ao mês, para os seguintes endpoints da API de Contas: ‘Saldos da conta’ e ‘Limites da conta’
...
Para a não contabilização de rechamadas, considerando que eventuais chamadas que possuam paginação devam ser interpretadas como uma única chamada, foi estabelecido a criação de um query parameter adicional para funcionar como identificador de rechamadas.
Esse novo parâmetro deve ter o nome pagination-key.
Cabe à Transmissora criar o identificador e enviá-lo via HATEOAS no retorno da chamada.
O tempo máximo de utilização do identificador pelo Receptor é de 60 minutos.
A Transmissora deve implementar validações para garantir a coerência da utilização do identificador, de acordo com as regras de limites operacionais.
Caso a Receptora utilize um pagination-key inválido ou expirado, a Transmissora deverá gerar um novo pagination-key retornando o resultado com sucesso. Esta chamada será contabilizada para os limites operacionais.
Essa implementação deve ser realizada em todos endpoints atuais com paginação.
A Transmissora poderá gerar um único ID para controle das chamadas das próximas páginas.
Exemplo do uso do pagination-key
Primeira chamada
GET /accounts/v2/accounts/12345678/transactions?page=1&page-size=1000
| Bloco de código |
|---|
{
“data”: [
“...”
],
“links”: {
“self”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=1&page-size=1000&pagination-key=123456”,
“first”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=1&page-size=1000&pagination-key=123456”,
“next”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=2&page-size=1000&pagination-key=123456”
},
“meta”: {
“requestDateTime”:”2021-05-21T08:30:00Z”
}
} |
...
Próximas chamadas
GET /accounts/v2/accounts/12345678/transactions?page=2&page-size=1000&pagination-key=123456
| Bloco de código |
|---|
{
“data”: [
“...”
],
“links”: {
“self”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=2&page-size=1000&pagination-key=123456”,
“prev”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=1&page-size=1000&pagination-key=123456”,
“first”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=1&page-size=1000&pagination-key=123456”,
“next”: ”https://api.banco.com.br/open-banking/accounts/v2/accounts/12345678/transactions?page=3&page-size=1000&pagination-key=123456”
},
“meta”: {
“requestDateTime”:”2021-05-21T08:30:00Z”
}
} |
...