Quiz 04 - Documentação e Mocks 📝

1. O que é o OpenAPI (OAS)?

Uma linguagem de programação para backend

Uma especificação padrão para descrever e documentar APIs RESTful

Um navegador web para desenvolvedores

Um banco de dados em nuvem

2. Qual a principal diferença entre OpenAPI e Swagger?

Swagger é pago e OpenAPI é gratuito

OpenAPI é a especificação e Swagger é o conjunto de ferramentas (UI, Editor, etc)

OpenAPI foi substituída pelo Swagger em 2021

Não há diferença, são nomes para a mesma cor

3. Para que serve o Swagger UI?

Para editar o banco de dados diretamente

Para gerar uma página visual e interativa onde se pode testar os endpoints documentados

Para compilar o código Java para o servidor

Para baixar músicas gratuitas

4. Qual o objetivo principal de um "Mock de API"?

Substituir o backup do sistema

Simular o comportamento de uma API real para permitir o desenvolvimento paralelo

Aumentar a segurança contra vírus

Esconder o endereço IP do servidor

5. O que significa "Developer Experience" (DX)?

O tempo que o desenvolvedor gasta jogando videogame

A facilidade e satisfação de um desenvolvedor ao usar sua ferramenta ou API

A quantidade de memória RAM do monitor

O nome do sistema operacional dos servidores

6. Qual formato de arquivo é mais utilizado para escrever especificações OpenAPI?

.html

.yaml ou .json

.docx

.pdf

7. Por que retornar mensagens de erro explicativas no corpo da resposta (Body) é uma boa prática?

Para o log ficar mais colorido

Para ajudar o consumidor da API a entender exatamente o que errou sem precisar perguntar ao autor

Porque o HTTP obriga a escrever textos longos

Para ocupar mais espaço no servidor

8. Qual componente do Swagger permite digitar e validar a especificação da API em tempo real?

Swagger Hub

Swagger Editor

Swagger Inspector

Swagger Play

9. Em qual fase do projeto o "Design de Contrato" deve ocorrer?

Somente no fim do projeto para arquivar

No início, antes mesmo de começar a codificar as rotas (API First)

Apenas se o cliente pedir

Nunca, é perda de tempo

10. Qual ferramenta pode ser usada para subir um mock server local a partir de uma collection?

Microsoft Excel

Postman / Mockoon

Notepad++

Windows Paint