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