API, webhook e JSON para quem não programa

Esta aula passa pelos termos técnicos que mais aparecem quando alguém começa a criar sistemas e automações. O Nicolas avisa que não é técnico: o que apresenta é a forma como pesquisou e interpretou esses conceitos, talvez não a definição literal, mas uma explicação que deixa tudo mais claro na hora de desenvolver.

O que é uma API e por que ela existe

A API é um contrato, uma chave que padroniza a troca de informações entre dois sistemas. Quando você conecta a API do Instagram a um sistema que criou, passa a ter acesso aos dados do Instagram de forma padronizada. Quem delimita o que você pode ver ou editar é o Instagram, com diferentes níveis de acesso, configurados na plataforma deles de acordo com a política da empresa.

Existem quatro motivos para a API existir. Reutilização: você usa funcionalidades prontas de outras pessoas, como a API dos Correios que calcula o frete a partir do CEP, gratuita e aberta até o momento. Segurança: quem fez a API controla o que você vê ou faz com as informações. Padronização: a API é um modelo de linguagem único, em que os sistemas trocam informações do mesmo jeito. Independência: o Instagram pode mudar algoritmo e código, mas enquanto a API permanecer igual, nada quebra. Com uma API, você faz cinco ações: conectar uma ferramenta, buscar dado em um sistema, enviar dado para outro, automatizar uma ação e integrar pagamentos.

HTTP: os verbos, os códigos de resposta e os headers

Dentro da API existe o HTTP, a forma como os computadores se comunicam. As requisições são verbos. GET pega informações sem alterar nada: ver uma página, buscar dados de um cliente, procurar produtos. POST cria: cadastrar um usuário, fazer um pedido, subir um arquivo, enviar uma mensagem ou um formulário. PUT e PATCH atualizam, como um cadastro ou uma configuração. DELETE apaga um usuário, um pedido, um arquivo.

Toda requisição tem uma resposta, sempre na casa das centenas. 100 é que ainda está processando. 200 é que deu certo. 300 é algum redirecionamento. 400 é algum erro na requisição. 500 é erro no servidor, que não tem a ver com a sua requisição. As requisições também têm os headers, os cabeçalhos: quem está enviando e por onde. Muitas vezes é no header que vai a chave de API, para você se identificar.

JSON e webhook

O JSON é a linguagem mais comum da internet: qualquer computador entende o formato, e com o tempo nós também. Ele é estruturado em categoria e valor, como "nome" e "Nicolas". Os valores podem ser texto, número, data, verdadeiro ou falso, o que permite categorizar e filtrar informações com precisão. O Nicolas não entra na escrita de código ou de JSON: é mais fácil pedir para a IA fazer e ir entendendo aos poucos, o suficiente para corrigir e aplicar nas automações.

O último conceito é o webhook. Diferente da API, que você solicita para buscar uma informação, o webhook avisa quando algo aconteceu. São gatilhos: quando determinada coisa acontece, ele informa. Pense nas notificações de um pedido: saiu para entrega, o entregador chegou na sua porta. Você configura os webhooks de acordo com o seu sistema e a sua realidade.

A aula é mais densa, mas não é preciso entender 100%. A IA faz a maior parte do trabalho. Entender esses termos facilita na hora de corrigir um erro ou um bug nas automações.