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 […]
Categoria: REST
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 […]
Criando um endpoint REST com ASP.NET Core
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 a parte teórica e o […]
Criando uma simples Web API RESTful em .NET Core 2.0
Fala pessoal nesse post criaremos uma pequena API RESTful totalmente do zero. Para isso no Visual Studio clique em Arquivo ? Novo ? Projeto ou simplesmente digite CTRL+Shift+N. Na tela a seguir selecione Visual C# ? .NET Core ? Aplicativo Web ASP.NET Core, defina o nome da sua solução no meu caso SimpleRestfulAPIWithAspNetCore e o […]
Testando serviços REST com Spring Boot e RestTemplate
Uma das principais características do Spring Boot é a sua simplicidade em permitir criar rapidamente uma aplicação sem abrir mão do design do seu código. E se você realmente quer fazer um trabalho de qualidade não pode abrir mão dos testes. Um bom modo de se fazer isso é com testes efetivos (não mocks) rodando […]
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 […]