API REST: Conceitos e Métodos

Prévia do material em texto

1. O que é uma API REST?
REST (Representational State Transfer) é um estilo de arquitetura para criar serviços web. Uma API REST é uma interface que segue os princípios do REST, permitindo que diferentes sistemas se comuniquem utilizando protocolos padrão como HTTP.
2. Quais são os principais métodos HTTP usados em uma API REST?
Os principais métodos HTTP usados são:
a. GET: para buscar dados.
b. POST: para criar novos dados.
c. PUT: para atualizar dados existentes.
d. DELETE: para remover dados.
e. PATCH: para atualizações parciais de um recurso.
3. O que são recursos em uma API REST?
Um recurso é uma entidade da aplicação que pode ser acessada por meio de uma URI (Uniform Resource Identifier). Por exemplo, em uma API para gerenciamento de usuários, o recurso "usuário" poderia ser acessado em /users.
4. O que significa REST ser "stateless"?
"Stateless" significa que cada requisição enviada ao servidor deve conter todas as informações necessárias para o servidor entender e processar a solicitação, sem depender de informações de requisições anteriores.
5. Qual a diferença entre os métodos POST e PUT em uma API REST?
POST é usado para criar um novo recurso. PUT é usado para atualizar um recurso existente ou criar um novo recurso em uma URI específica se ele não existir.
6. Como são usados os códigos de status HTTP em APIs REST?
Códigos de status HTTP indicam o resultado da requisição. Exemplos:
a. 200 OK: A requisição foi bem-sucedida.
b. 201 Created: Um novo recurso foi criado com sucesso.
c. 400 Bad Request: A requisição está malformada.
d. 404 Not Found: O recurso solicitado não foi encontrado.
e. 500 Internal Server Error: Ocorreu um erro no servidor.
7. O que é o conceito de "HATEOAS" em APIs REST?
HATEOAS (Hypermedia as the Engine of Application State) é uma característica das APIs REST que permite que o cliente descubra dinamicamente as ações que pode realizar em um recurso, através de links fornecidos nas respostas da API.
8. Como a segurança pode ser implementada em APIs REST?
A segurança em APIs REST pode ser implementada de várias maneiras, incluindo:
a. Autenticação via tokens (como JWT).
b. Uso de HTTPS para encriptar a comunicação.
c. Controles de CORS para restringir quem pode acessar a API.
d. Limitação de taxas de requisição (rate limiting).
9. O que são parâmetros de consulta em uma API REST?
Parâmetros de consulta (query parameters) são usados para passar informações adicionais em uma requisição HTTP, geralmente anexados à URL após um ?. Por exemplo: /users?age=30&country=BR filtra usuários por idade e país.
10. Qual a diferença entre APIs REST e SOAP?
REST é mais simples e utiliza formatos de dados leves como JSON, enquanto SOAP (Simple Object Access Protocol) é um protocolo mais robusto, que usa XML para a troca de informações e possui uma estrutura mais complexa e específica. REST também é mais flexível em relação ao uso de diferentes métodos HTTP.