Knowledge about REST APIs Design

Knowledge about REST APIs Design

A badge Knowledge about REST APIs Design certifica os conhecimentos e o domínio da
pessoa participante no desenho de APIs REST, seguindo boas práticas em conformidade com
o protocolo HTTP, e que estão preparadas para evolução e manutenção a médio e longo prazo.
Esta badge inclui, mas não se limita, a práticas e técnicas de desenho e implementação de
APIs REST, indicando que a pessoa participante é capaz de:
1. Definir o que é REST e identificar quais características fazem parte da definição e
quais não fazem;
2. Desenhar uma API REST de CRUD para uma determinada entidade persistivel do meu
sistema;
3. Explicar e desenhar uma API REST seguindo o 2° nível do Modelo de Maturidade de
Richardson;
4. Documentar, manter e evoluir a documentação de uma API REST;
5. Explicar e avaliar desenhos e implementações de idempotência em APIs REST;
6. Avaliar, alterar e evoluir uma API REST, incluindo seu versionamento, sem quebrar a
compatibilidade com os clientes existentes;
7. Identificar, avaliar e criticar problemas de design em uma API REST durante um code
review;
8. Definir, avaliar e criticar os status e códigos HTTP de retorno em uma API REST;
9. Evoluir uma API REST síncrona para o modelo assíncrono e avaliar os possíveis
impactos na migração;
10. Desenhar uma API REST capaz de consultar entidades que possuem um alto volume
de dados no lado servidor;
11. Explicar como o protocolo HTTP funciona;
12. Explicar, avaliar e aplicar os cabeçalhos HTTP de cache em uma API REST;
13. Explicar as diferenças semânticas e casos de uso entre os métodos HTTP PUT e
PATCH;
14. Desenhar e avaliar uma API REST que suporta o mecanismo de Content Negotiation;
15. Identificar e explicar os métodos de autenticação e autorização mais populares em
APIs REST;


O que é necessário para conquistar este badge

Para conquistar essa badge, é necessário obter 80% ou mais de aproveitamento na
avaliação


Quem já tem este badge

Emissor deste badge