JSON e integrações — como sistemas diferentes conversam entre si
O idioma comum que permite seu sistema contratar funcionalidades prontas de outras empresas.
O que é JSON, no fundo
Por que JSON virou o idioma comum
API de terceiros
Webhook
00 — O QUE É JSON, NO FUNDO
Um formato de texto simples pra representar dados estruturados
JSON é um formato de texto usado pra representar informação de forma organizada, usando pares de chave e valor("nome": "Ana") e listas de itens — parecido com a "ficha" e a "lista" que vimos no Módulo 1, só que escritas de um jeito que qualquer sistema, em qualquer linguagem de programação, consegue ler e escrever sem confusão.
Metáfora: pense numa embalagem de produto com informação padronizada — peso, validade, ingredientes — sempre no mesmo formato, não importa em que país ou fábrica o produto foi feito. JSON é essa embalagem padronizada pra informação circular entre sistemas diferentes.
01 — POR QUE JSON VIROU O IDIOMA COMUM
Leve, fácil de ler e suportado por praticamente tudo
Antes de existir um formato tão difundido, cada sistema tendia a usar seu próprio jeito de organizar dados, dificultando a comunicação entre empresas e tecnologias diferentes. O JSON se popularizou porque é leve (poucos caracteres extras), fácil de ler tanto por humano quanto por máquina, e hoje é suportado nativamente por praticamente toda linguagem de programação moderna — JavaScript, Python, e as demais que vimos no Módulo 5.
Metáfora: é como o inglês em reuniões internacionais de negócios: não é a língua nativa de ninguém na sala, necessariamente, mas é o idioma comum que todo mundo aprendeu, o que evita que cada país precise aprender o idioma de todos os outros.
reconhecer 1 — JSONpendente
Por que JSON é útil como formato de troca de dados entre sistemas diferentes?
APorque é leve, fácil de ler e suportado nativamente por praticamente toda linguagem de programação
BPorque só funciona em JavaScript, a linguagem que dá nome a ele
CPorque substitui a necessidade de existir um banco de dados
02 — API DE TERCEIROS
Contratar uma funcionalidade pronta, em vez de construir do zero
Lembrando o Módulo 3 (cliente e servidor): quando seu sistema precisa de uma funcionalidade que uma outra empresa já resolveu bem — enviar e-mail, processar um pagamento, gerar uma nota fiscal — ele faz um pedido pra API dessa empresa, trocando dados em JSON, e recebe uma resposta de volta. Isso evita reconstruir do zero algo que já existe pronto, testado e mantido por quem é especialista naquilo.
Metáfora: é como terceirizar a entrega de um produto pra uma transportadora, em vez de montar sua própria frota de caminhões — você entrega o pacote com as informações certas, e a transportadora especializada cuida do resto.
No seu projetoO Enf Pró Cards usa a API do Resend pra enviar e-mails — em vez de construir um servidor de e-mail do zero, seu sistema manda um pedido em JSON com o destinatário e o conteúdo, e o Resend cuida da entrega.
reconhecer 2 — API de terceirospendente
Qual é a principal vantagem de usar uma API de terceiros pra uma funcionalidade como envio de e-mail?
AAproveitar uma solução pronta e especializada, sem precisar construir e manter essa infraestrutura do zero
BEliminar completamente a necessidade de qualquer backend próprio
CGarantir que o sistema nunca mais precise de banco de dados
03 — WEBHOOK
O outro sistema avisa o seu, em vez de você ficar perguntando
Numa API tradicional, é o seu sistema quem pergunta "aconteceu alguma coisa?". Um webhook inverte essa direção: você combina com o outro sistema um endereço do seu servidor, e assim que um evento relevante acontece do lado dele — como um pagamento ser confirmado — ele mesmo envia um pedido pro seu servidor avisando, sem você precisar ficar perguntando repetidamente se já aconteceu.
Metáfora: é a diferença entre ficar ligando de hora em hora pra saber se a encomenda chegou (API tradicional) e receber uma notificação automática assim que o entregador toca a campainha (webhook) — você é avisado no momento exato, sem precisar perguntar.
No seu projetoA integração com a Kiwify no Enf Pró Cards funciona por webhook: assim que um pagamento é aprovado do lado da Kiwify, ela avisa automaticamente o seu servidor, que libera o acesso do aluno.
reconhecer 3 — webhookpendente
O que diferencia um webhook de uma chamada de API tradicional?
ANo webhook, é o outro sistema quem avisa o seu automaticamente quando um evento acontece, em vez do seu sistema precisar perguntar repetidamente
BWebhook não usa JSON, só API tradicional usa
CWebhook só funciona dentro da mesma empresa, nunca entre sistemas de empresas diferentes
04 — desafio final do módulo 7: Uma plataforma de cursos quer: liberar o acesso do aluno automaticamente assim que um pagamento externo é confirmado, e enviar um e-mail de boas-vindas usando um serviço pronto de terceiros, trocando dados num formato que ambos os sistemas entendam. Quais conceitos deste módulo resolvem cada parte desse pedido?
desafio finalpendente
Escolha a alternativa que associa corretamente cada necessidade ao conceito certo.
AWebhook (aviso automático do pagamento confirmado) + API de terceiros (envio do e-mail) + JSON (formato comum de troca entre os sistemas)
BUm banco de dados NoSQL resolve os dois problemas sozinho
CCache substitui a necessidade de webhook e de API de terceiros