Aula 13 - Ultima do Módulo Flashcards
O que é paginação?
Quando a response é separada em páginas. 10 itens por página por exemplo. Isso torna a API menos sobrecarregada.
O que são os filtros?
Quando, através de parâmetros, é possível ser mais específico sobre informação na qual se quer chegar.
Por que definir recursos lógicos?
Porque essa prática cumpre com pelo menos o nível 1 de maturidade de Richardson, tornando a API mais organizada.
O que se quer dizer com ‘Tolerância a Falhas’?
Quer dizer que a API tem que tratar dos erros de forma responsável através de mensagens de erro claras.
O que é cache?
É uma prática que respeita uma das constraints do REST. Por isso é uma boa prática.
O que é conectividade?
Garantir que a API esteja sempre acessível e saudável.
Por que definir timeouts?
Porque caso uma requisição demore mais do que o normal, ela pode ficar consumindo recursos do servidor, algo que vai sair mais caro no final. A API deve encerrar o processamento e retornar uma mensagem de erro.
Por que documentar a API?
Ferramentas como Swagger e HATEOAS podem ajudar a criar uma documentação poderosa e interativa. Isso facilita tanto para o desenvolvedor quando para o consumidor.
Por que a API tem que ser self service?
Como explicado em ‘Por que documentar a API?’, quando uma API está bem documentada, os desenvolvedores tem mais facilidade em utilizá-la ou atualizá-la, sem a ajuda de suporte adicional.
O que é SSL?
É um protocolo de segurança que criptografa a comunicação entre um client e um server.
Por que aplicar o versionamento?
Evita que mudanças na API quebrem os sistemas que dependem dela.
Por que testar?
Garantir que a API funcione corretamente.
O que é suporte a exportação?
Quando a API retorna algo em JSON, mas o cliente pode precisar daquela informação em outros formatos, é sempre legal implementar uma funcionalidade para isso.
O que é o I18n (Globalization)?
Em contextos em que a API é usada em vários países, é uma boa prática ajustar formatos de data e hora, traduzir mensagens de erros e considerar variações regionais nos dados.
Por que notificar o cliente?
É sempre bom notificar o cliente quando o pedido foi recebido (status code 201) e, quando o processo for concluído, notificar novamente.
