Skip to main content
30 de setembro de 2026 Atualização do produto Ação necessária

Afeta


Equipes que se integraram com a API do Lerian SPI antes dessas mudanças.

O que mudou


O Lerian SPI 1.0.0, lançado em 29 de setembro de 2026, traz estas mudanças. O header de idempotência mudou para X-Idempotency. As APIs SPI, DICT, BR Code e Core deixaram de ler Idempotency-Key e passaram a ler a chave de idempotência de X-Idempotency. Uma requisição que carregava apenas Idempotency-Key passou a ser recusada como uma requisição sem chave. Duas consultas passaram para POST. A lista de Pix recebidos passou de GET /api/v1/spi/pix para POST /api/v1/spi/pix, e os filtros cpf e cnpj passaram para o corpo JSON da requisição. As estatísticas de pessoa passaram de GET /api/v1/dict/persons/{taxId}/statistics para POST /api/v1/dict/persons/statistics, com taxId no corpo JSON da requisição. As rotas de casos MED do Core foram removidas. As oito rotas em /api/v1/core/med foram removidas. O participante direto passou para uma rota própria. POST /api/v1/core/participants/ deixou de aceitar um participante direto, e o registro do participante direto passou para a rota administrativa POST /api/v1/core/participants/direct.

Impacto


Classificação: Ação necessária. Um cliente que ainda envia Idempotency-Key, chama uma das duas consultas GET, chama uma rota MED do Core ou envia um participante direto para POST /api/v1/core/participants/ recebe um erro.

O que você precisa fazer


  • Envie a chave de idempotência em X-Idempotency.
  • Chame a lista de Pix recebidos com POST, com cpf e cnpj no corpo JSON e os outros filtros ainda na query.
  • Chame as estatísticas de pessoa com POST, com taxId no corpo JSON.
  • Peça a um administrador autorizado para registrar um participante direto em POST /api/v1/core/participants/direct; POST /api/v1/core/participants/ aceita só participante indireto.
  • Trate os casos MED pela API DICT.

Recursos