Se você não está muito familiarizado com APIs, pode estar se perguntando… por que toda essa confusão em torno do versionamento de API’s? Se você já foi impactado por mudanças em APIs, provavelmente é você quem está preocupado. Se você é o responsável por manter uma API, também pode estar lidando com perguntas desafiadoras como […]
Tag: API
Guia Prático dos Status Codes HTTP em APIs REST
Introdução Quando desenvolvemos uma API REST, um dos aspectos mais cruciais é garantir que as respostas enviadas ao cliente sejam claras, consistentes e úteis. Uma maneira de alcançar isso é utilizando corretamente os HTTP status codes. Esses códigos são responsáveis por comunicar o resultado de uma operação, e sua correta implementação pode facilitar a integração […]
Entendendo o conceito de HATEOAS
Introdução No universo das APIs REST, uma das características mais avançadas e menos compreendidas é o conceito de HATEOAS (Hypermedia as the Engine of Application State). Ao contrário de outros tipos de APIs que exigem uma documentação externa ou um contrato pré-estabelecido, o HATEOAS propõe um modelo onde as próprias respostas da API guiam o […]
Aplicações RESTful HATEOAS com SpringBoot
O HATEOAS, é uma das principais constraints arquiteturais do REST e possibilita a navegação entre recursos, que são representações dos modelos de negócio da aplicação. Esse post é bem mão na massa e se quiser aprofundar um pouco mais em conceitos teóricos de HATEOAS confira o nosso post Entendendo HATEOAS. Vamos tomar como base […]
Entendendo HATEOAS
HATEOAS (Hypermedia as the Engine of Application State) é uma constraint arquitetural de aplicações REST. Uma API HATEOAS provê informações que permite navegar entre seus endpoints de forma dinâmica visto que inclui links junto às respostas. Esta capacidade a difere de sistemas baseados em SOA e interfaces dirigidas por WSDL(pronuncia-se uísdou). Com SOA, servidores e […]
Documentando aplicações REST com SpringBoot e Swagger
O Swagger é um dos frameworks mais usados para se documentar API’s REST. Ele facilita para que os clientes que consomem nossas API’s saibam quais os parâmetros nossas operações recebem, qual o retorno, o modelo, o media type retornado JSON, XML, CSV, binário etc. Sendo assim os clientes não precisam necessariamente discutir com a equipe […]
Criando o primeiro endpoint REST com SpringBoot
Neste post daremos continuidade a uma série de postagens sobre Web-Services divididos entre conceitos teóricos e praticos. Nos 3 primeiros posts focou-se em teoria com um sobre Web Services, outro sobre RESTful Web Services e mais um sobre os HTTP Status Codes mais comuns. Este post por sua vez complementa o que foi desenvolvido no […]
HTTP Status Codes em Serviços REST
Uma boa prática ao se desenvolver serviços REST é retornar status codes adequados a cada operação executada. Isso tem uma importância ainda maior quando se trata de uma exceção, uma vez que diferentementemente de um serviço SOAP uma aplicação verdadeiramente REST não retorna a exception para o usuário. Sendo assim é fortemente recomendado que ao […]
RESTful Web Services
Dando seqüência a série de postagens sobre Web-services neste post, discutiremos sobre a JAX-RS 2.0 a especificação para serviços baseados em RESTful. No mundo REST, você pode acessar tudo como um recurso e eles possuem um identificador único a URI(Uniform Resource Identifier). Um servidor REST e seus clientes interagem usando o protocolo HTTP e seus […]
Web Services
Nos últimos meses me pediram a definição de Web-services em 3 processos seletivos diferentes, por mais simples que possa parecer definir conceitualmente pode ser mais complexo do que parece, sendo assim decidi fazer uma série de posts a respeito. Neles iremos aprender sobre os diferentes tipos de Web Services – ou simplesmente serviços. Pra começo […]