- name
SKILL.md
O arquivo da skill permanece no repositório do publicador.
Cole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add rrezartprebreza/spring-boot-skills --skill api-versioning -a cursor -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add rrezartprebreza/spring-boot-skills --skill api-versioning -a claude-code -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add rrezartprebreza/spring-boot-skills --skill api-versioning -a codex -yCole o comando copiado em um terminal. Ele instala este SKILL.md nesse agente.
npx skills add rrezartprebreza/spring-boot-skills --skill api-versioning -a grok -yEnvie a mensagem copiada em um chat do Grok Bot. O Bot busca este SKILL.md no GitHub e o adiciona às skills que todos os seus Bots compartilham.
Install this skill: https://github.com/rrezartprebreza/spring-boot-skills/tree/HEAD/skills/spring-boot-3/api-versioningDo publicador
Boot 3 does not provide Boot 4's built-in mapping version attribute. Choose one explicit
strategy and keep it consistent: URL segments, a request header, or media-type parameters.
For a public API, /api/v1/orders and /api/v2/orders are usually the clearest choice. If URLs
must remain stable, resolve a request header at the web boundary and route to versioned handlers.
Do not hide version selection in business services or duplicate it across filters and controllers.
@RestController
@RequestMapping("/api/v1/orders")
class OrderV1Controller {
@GetMapping("/{id}")
OrderV1 get(@PathVariable UUID id) { ... }
}
Document supported versions in OpenAPI, define a removal policy, and return a consistent error for
unsupported versions. Add Deprecation, Sunset, and Link headers through a response advice or
filter when retiring a version.
Keep version-specific DTOs and controllers thin. Map both versions to the same application use case, and do not copy domain logic into each version. Add contract tests for every supported version and verify content negotiation if using media types.
version attribute on Boot 3 - it is not available; choose an explicit routing strategy.>
---name: api-versioningdescription: >---# skills/spring-boot-3/api-versioning/SKILL.mdPerguntas frequentes
Baixe skills/spring-boot-3/api-versioning/SKILL.md do publicador ou copie o caminho e abra o repositório. O PlugMCP lista a skill e não hospeda o arquivo.
O publicador o mantém em https://github.com/rrezartprebreza/spring-boot-skills.
Claude, Cursor, Codex e Grok Build conseguem ler um SKILL.md que você adiciona a partir do repositório do publicador. O Grok Bot o instala quando você envia em um chat o link da pasta da skill no GitHub.