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 […]
Categoria: API
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 […]
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 […]
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 […]