🚀 Capítulo 05: JSON: O Idioma das APIs (Tema: Minecraft)

NOTE

Este capítulo utiliza a temática de Minecraft para explicar o JSON. Cada bloco e item no jogo tem propriedades que podem ser guardadas de forma estruturada!


1. 🎯 Objetivo da Aula

Compreender o formato JSON (JavaScript Object Notation), sua estrutura de chave-valor e como ele é usado para transportar dados entre Cliente e Servidor.

2. 🏢 O Cenário Prático (Seu Desafio)

No Minecraft, cada bloco de minério tem propriedades: o tipo do minério, a dureza, se precisa de picareta de ferro ou não. Para enviar esses dados do jogo para um site que mostra o inventário do jogador, precisamos empacotar essas informações em um formato que o site entenda. Vamos usar o JSON, empilhando blocos de dados!

3. 🧠 Fundamentos: A Teoria Traduzida

JSON significa JavaScript Object Notation. É um formato leve de troca de dados, fácil de ler e escrever para humanos e fácil de interpretar para máquinas.

🧱 Regras dos Blocos JSON:

  1. Chave-Valor: Os dados são guardados em pares de "chave": valor.
  2. Chaves sempre entre aspas duplas ("nome").
  3. Tipos de Dados permitidos:
    • Texto (String): Entre aspas duplas ("Diamante").
    • Número: Sem aspas (42, 10.5).
    • Booleano: true ou false.
    • Array (Lista): Entre colchetes [].
    • Objeto: Outro bloco JSON entre chaves {}.

⛏️ Exemplo de um Bloco de Minecraft em JSON:

{
  "nome": "Minério de Diamante",
  "dureza": 3.0,
  "precisa_ferro": true,
  "drops": ["Diamante", "XP"]
}

4. 📖 Exemplo Guiado: Validando o JSON

Um JSON sempre começa e termina com chaves {} (se for um objeto) ou colchetes [] (se for uma lista).

  • Correto: {"id": 1}
  • Errado: {id: 1} (Falta aspas na chave).
  • Errado: {"nome": 'Steve'} (Usou aspas simples no valor texto).

5. 🛠️ Prática Obrigatória 1: Criando seu Item

Crie um objeto JSON que represente uma Picareta do Minecraft. O JSON deve ter:

  • Um texto para o "material".
  • Um número para a "durabilidade".
  • Um booleano para "esta_encantada".
  • Uma lista de textos para os "encantamentos".

6. 🛠️ Prática Obrigatória 2: Corrigindo o JSON

O JSON abaixo está com erros de sintaxe. Reescreva-o de forma correta:

{
  nome: Steve,
  "vida": 20,
  'inventario': ['Espada', 'Tocha']
}

7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)

  1. Faça o Commit: No GitHub Desktop, digite a mensagem (ex: Finaliza Capítulo 05 Backend) e clique em Commit to main.
  2. Envie para a Nuvem (Push): Clique em Push origin.

8. 📂 Estrutura de Pastas

mod_07_backend_e_apis/
├── capitulos/
│   ├── capitulo_05_json.md
│   └── codigos/
│       └── cap05/
│           └── item_minecraft.json

9. 💡 Checkpoint de Lógica

Por que o JSON se tornou mais popular que o XML para APIs web? (Dica: JSON parece muito com objetos JavaScript, que rodam no navegador!).

10. 🔥 Desafio de Fixação

Crie um JSON que represente uma lista de 3 jogadores do Minecraft, onde cada jogador é um objeto com nome e nível.

11. 🔑 Gabarito de Código/Fórmulas

Gabarito da Prática 2 (Corrigido):

{
  "nome": "Steve",
  "vida": 20,
  "inventario": ["Espada", "Tocha"]
}

Capitulo Anterior | Proximo Capitulo