Integrando APIs de terceiros com IA

Começa o Módulo 6 — APIs de Terceiros. Nenhum produto sério vive sozinho: ele conversa com IA, e-mail, analytics, billing, dados externos. No ClubPetro a gente integra muita coisa — e vibe coding acelera isso bastante, desde que com os padrões certos. Este post abre o módulo com a mentalidade.

Por que integração combina com vibe coding

Integrar API de terceiro é, em boa parte, trabalho previsível: ler a doc, montar o cliente, tratar a resposta, lidar com erro. A IA é ótima nisso — especialmente quando você dá a ela a documentação atual (não a que ela "lembra" do treino, que pode estar desatualizada).

Dica de ouro do nosso fluxo: pra doc de biblioteca/SDK, a gente consulta fontes atualizadas em vez de confiar na memória do modelo. API muda; memória de treino congela.

O leque que integramos

Só pra dar a dimensão do que o ClubPetro pluga:

• IA: Anthropic (Claude) — o motor (post #34).
• E-mail: Resend (post #35).
• Marketing/dados: Google Analytics, Search Console, Google Ads, Facebook Ads (post #36).
• Infra/FinOps: GCP, BigQuery.
• Código: Bitbucket (produtos core) e GitHub (este admin).
• Mensageria: Evolution API (Módulo 5).

Cada uma é opcional por feature, ativada por variável de ambiente.

Os 4 padrões que valem pra toda integração

Independente da API, a gente repete o mesmo cuidado (cada um vira post ou seção adiante):

1. Secrets fora do código — chave sempre em env, nunca commitada (#37).
2. Resiliência — rate limit, retry, timeout, idempotência (#37).
3. Camada de abstração — encapsular o cliente do terceiro num módulo nosso, pra não espalhar a dependência pelo código.
4. Degradação graciosa — se o terceiro cai, a feature degrada, não derruba a plataforma.

A regra "antes de construir, veja se já existe"

Vibe coding maduro também é saber não integrar. Às vezes a melhor integração é a que você não faz — porque já existe um produto gerenciado que resolve melhor. A energia do time é pra construir o que é do ClubPetro, não pra reimplementar o que o mercado já entrega pronto e seguro.

⚠️ Armadilha #33: deixar a IA gerar integração baseada na API que ela "lembra". SDKs mudam de versão e assinatura. Sempre alimente a doc atual — código que compila com a API velha quebra com a nova.

Próximo da série: #34 — Anthropic SDK: colocando Claude dentro do produto.