API: conectando outros serviços
Aula 16 de 26 do curso “Vibe coding”. Grátis, com animações e teste.
API: programas conversando
API (interface de programação) é o jeito de um programa pedir algo a outro. Como um garçom: você não entra na cozinha, passa o pedido e o prato chega. Seu servidor manda uma requisição, o serviço responde com dados. Exemplo da aula: um site de agendamento para o seu amigo barbeiro. O cliente agenda, e o site sozinho manda e-mail, cobra um sinal e responde dúvidas.
O que dá para conectar
Quase tudo de útil já existe como API. E-mail: Resend ou Brevo mandam “você está agendado para sexta”. Pagamento: Stripe ou um serviço de pagamento local do seu país. IA: a API da Anthropic ou da OpenAI, para um bot responder clientes. E ainda clima, mapas, tradução. No esquema é o bloco da direita. Confira se o serviço e o pagamento estão disponíveis no seu país.
O caminho da chave
A conexão é quase sempre igual. 1) Você se cadastra no serviço. 2) Pega uma chave de API: uma senha para programas (aula de chaves). 3) Coloca nas variáveis de ambiente do servidor, não no código. 4) O servidor usa a chave para chamar a API. 5) O front-end só chama o seu servidor. O navegador nunca vê a chave: como no esquema, ela fica no servidor.
Webhook: o serviço liga para você
Normalmente quem liga é você: seu servidor pergunta, o serviço responde. Webhook é o contrário: o serviço bate no endereço do seu servidor quando algo acontece. Exemplo: o cliente paga o corte, o serviço de pagamento manda o webhook “pagamento aprovado” e o servidor marca o horário como pago. É a seta tracejada do esquema. Verifique a assinatura do webhook: assim o servidor sabe que é mesmo o serviço, e não um engraçadinho.
Documentação e modo de teste
A documentação é o manual do serviço para usar a API dele. Passe o link para o agente e peça que siga a documentação: assim ele inventa menos. Comece no modo de teste: serviços de pagamento têm um sandbox onde o pagamento é de mentira e nenhum dinheiro sai. Teste o caminho todo: agendamento, e-mail, pagamento, webhook. Funcionou? Só então troque para as chaves de produção, ou seja, as reais.
Teste-se
- Onde deve ficar a chave de API do serviço de pagamento?
Resposta certa: Nas variáveis de ambiente do servidor. A chave no servidor não aparece para o navegador. O front-end pede ao seu servidor, e ele chama a API com a chave. - O que é um webhook?
Resposta certa: O serviço chama seu servidor quando algo acontece. Normalmente quem pergunta é seu servidor. O webhook é o contrário: o serviço avisa, por exemplo “pagamento aprovado”. - Como começar a conectar pagamentos?
Resposta certa: Com o modo de teste, sem dinheiro de verdade. No sandbox dá para testar o caminho todo sem risco. As chaves reais entram quando tudo funciona.
← Banco de dados e login Tarefas em segundo plano e agendamento →