> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Mudanças no contrato da API do Lerian SPI

> Quatro mudanças no contrato da API entregues no Lerian SPI 1.0.0: o header de idempotência, duas consultas em POST, casos MED no DICT e uma rota separada para o participante direto.

<Badge stroke icon="calendar-days" iconType="regular">30 de setembro de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Atualização do produto</Badge> <Badge color="purple" size="lg" stroke icon="eye" iconType="regular">Ação necessária</Badge>

## 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

***

* [O que é o Lerian SPI?](/pt/rails/spi/what-is-lerian-spi)
* [Como o Lerian SPI funciona](/pt/rails/spi/how-spi-works)
* [Lista de erros do SPI](/pt/reference/rails/spi/spi-error-list)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.