studies
Versionamento de API
HomePrincípios de Programação Orientada a ObjetosTrabalhando com ObjetosTrabalhando com CollectionsTrabalhando com StringsTrabalhando com ExceptionsApi, camadas, CRUD, exceptions, validationProjeto Arquitetura RESTfulCriando um projeto REST / RESTfulSPRING DATA JPA - 2024Estudo Arquitetura LimpaEstudo sobre Anotações SpringModelo de Dominio e ORMAPI REST, camadas, CRUD, exceções, validaçõesJPA, Consultas SQL e JPQLLogin e controle de acessoTestes automatizados, JUnit5 e MockitoValidação e SegurançaSignup e finalizaçãoCobertura de testes com JaCoCoTestes API - MockMvc e RestAssuredEstudo Definitivo ORMEstudo upload arquivos AWSDocumentando API (Swagger e OpenAPI)Versionamento de APIHateoasWorkshop MongoDBWorkshop CassandraSpring Webflux - MongoDBSpring Batch - IntrodutórioSpring Batch Avançado - Lendo dados API remotaSpring Batch - Envio de Email em massaRoad map estudo
Versionamento de API
HomePrincípios de Programação Orientada a ObjetosTrabalhando com ObjetosTrabalhando com CollectionsTrabalhando com StringsTrabalhando com ExceptionsApi, camadas, CRUD, exceptions, validationProjeto Arquitetura RESTfulCriando um projeto REST / RESTfulSPRING DATA JPA - 2024Estudo Arquitetura LimpaEstudo sobre Anotações SpringModelo de Dominio e ORMAPI REST, camadas, CRUD, exceções, validaçõesJPA, Consultas SQL e JPQLLogin e controle de acessoTestes automatizados, JUnit5 e MockitoValidação e SegurançaSignup e finalizaçãoCobertura de testes com JaCoCoTestes API - MockMvc e RestAssuredEstudo Definitivo ORMEstudo upload arquivos AWSDocumentando API (Swagger e OpenAPI)Versionamento de APIHateoasWorkshop MongoDBWorkshop CassandraSpring Webflux - MongoDBSpring Batch - IntrodutórioSpring Batch Avançado - Lendo dados API remotaSpring Batch - Envio de Email em massaRoad map estudo
  • Objetivo
  • Por quê versionar uma API REST
  • Versionamento via URI
    • Características
    • Prática
    • Entity
    • DTO
    • Controller
    • Service
    • Ajuste final Controller
  • Versionamento via Media Type
    • Características
    • Prática
    • Controller
    • Postman
Fornecido por GitBook
Nesta página
  • XML
  • JSON

Por quê versionar uma API REST

AnteriorObjetivoPróximoVersionamento via URI

Atualizado há 5 meses

O primeiro motivo é com relação ao formato de dados. O formato define como os dados serão trocados entre um web server e um cliente.

Seja quando acessamos determinado site ou requisitamos alguma informação de uma API, ela vai trocar os dados conosco.

Esses dados podem ser definidos em alguns formatos, como JSON e XML.

Porém, a ideia é que seja disponibilizado nos dois.

XML

JSON

E disponibilizar também endpoints para serem consultados no formato JSON.

Logo, para termos ambos formatos, precisamos versionar a nossa API REST.

Mas podemos ter outro motivo também! Os dados podem ter uma mudança significativa por um determinado endpoint:

No exemplo acima, o JSON possui a propriedade salary! Podemos considerar o lado esquerdo como uma Versão 0 (padrão) e a do lado direito como uma Versão 1.0.

Ideal para um serviço mais legado que permanecerá disponível.