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, comcpfecnpjno corpo JSON e os outros filtros ainda na query. - Chame as estatísticas de pessoa com
POST, comtaxIdno 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.

