Consulta de um reprocessamento em lote

stable

Este endpoint possibilita consultar os reprocessamentos em lote que foram previamente criados. A consulta retornará informações detalhadas como quantidade de eventos reprocessados, status, datas e contexto.

🚧

Importante

Recomendamos que o parceiro estabeleça uma rotina de consulta de mensagens enviadas para que identifique eventuais falhas no recebimento de eventos e, dessa forma, possa solicitar o reprocessamento de eventos.

Requisição (Request)

Requisição HTTP

GET https://api-mtls.sandbox.bankly.com.br/webhooks/processed-messages/batch
--request  GET 'https://api-mtls.sandbox.bankly.com.br/webhooks/processed-messages/batch?StartDate=2025-01-01&endDate=2025-02-28&page=1&pageSize=100' \  
--header 'Content-Type: application/json' \  
--header 'Authorization: Bearer {{token}}' \

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:

ScopeDescrição
webhook.readConcede acesso para consultar configurações de webhooks, pesquisar mensagens enviadas e realizar o reprocessamento de mensagens.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.
AuthorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

No path desta requisição envie os seguintes campos:

NomeTipoDescriçãoEspecificação
startDatequeryObrigatório. Data inicial dos eventos a serem exibidos na pesquisa.Formato YYYY-MM-DD.
endDatequeryObrigatório. Data final dos eventos a serem exibidos na pesquisa.Formato YYYY-MM-DD.
pagequeryNúmero da página que deseja consultar.Valor padrão: 1
pageSizequeryQuantidade de resultados a serem exibidos por página.Valor padrão: 10. Máximo permitido: 100

🚧

Importante

Os campos startDate e endDate consideram somente valores de datas. Horas, minutos e segundos são ignorados.

Corpo da requisição (Body)

Não é necessário enviar campos no body desta requisição.

Resposta (Response)

O status code 200 indicará sucesso na consulta.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

NomeTipoDescriçãoNúmero máximo de caracteres
reprocessedEventsnumberRetorna a quantidade de eventos já reprocessados.
totalEventsnumberRetorna a quantidade de eventos a serem reprocessados.
idstringIdentificador único do lote.
startDatestringData inicial dos eventos, no formato YYYY-MM-DD.
endDatestringData final dos eventos, no formato YYYY-MM-DD.
contextstringContexto do evento.
eventNamesarray of stringsLista que contém o nome dos eventos.
companyKeystringChave que identifica o parceiro dentro do Bankly.
correlationIdstringIdentificador que correlaciona todo o fluxo das operações.
statusstringSituação do lote de eventos.20
createdAtstringData de criação da solicitação do reprocessamento em lote, no formato ISO 8601 - UTC.
updatedAtstringData da última atualização do reprocessamento, no formato ISO 8601 - UTC.
[
    {
        "reprocessedEvents": 4828,
        "totalEvents": 4828,
        "id": "12f89f4b-d382-43bd-b9e8-4c12e4f0b91b",
        "startDate": "2025-01-01",
        "endDate": "2025-02-28",
        "context": "Customer",
        "eventNames": [
            ""
        ],
        "companyKey": "AUTOMATED_TESTS",
        "correlationId": "6817a085-9bd4-413f-aa80-c8889912b8fc",
        "status": "DONE",
        "createdAt": "2025-03-05T21:28:13.837",
        "updatedAt": "2025-03-05T21:46:19.667"
    }
]

👍

Dica

Para simular uma requisição nesse endpoint, acesse o API Reference.

Status dos eventos

StatusDescrição
WAITINGEstado inicial do reprocessamento em lote.
PROCESSINGIndica que os lotes estão sendo reprocessados.
FAILUREIndica que houve falha durante o reprocessamento.
DONEIndica que o reprocessamento foi concluído com sucesso.

Erros

Este endpoint pode retornar erros específicos, conforme a tabela a seguir:

Status CodeCódigoMensagemDescrição
422INVALID_BATCH_WEBHOOK_SEARCHPageSize with disallowed quantity. The value must be between 1 and 100O valor informado no campo PageSize apresenta uma quantidade não permitida. Informe um valor entre 1 e 100.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês que acompanham os erros 400 (se houver).

Eventos

Este endpoint não possui eventos relacionados a ele.


Copyright © 2021 Acesso Soluções de Pagamento S.A - Todos os direitos reservados