API

É o contrato pelo qual um sistema expõe funções e dados para que outro sistema os use: o que pode ser pedido, com quais parâmetros, o que é retornado e o que acontece em caso de erro. APIs REST são o padrão mais comum na web: usam o protocolo HTTP e organizam o acesso em recursos, como “contratos/48213”. Em IA, as APIs estão em toda parte: os modelos são consumidos por API, as capacidades de IA são expostas como API, e as ferramentas de agentes são, na prática, chamadas de API.

Em Produto, toda capacidade de IA em produção é uma API com contrato: entrada, saída, tempo máximo de resposta, comportamento em falha e versão. O time de Produto precisa entender o suficiente para ler esse contrato e fazer as perguntas certas. A pergunta mais importante costuma ser: “o que acontece quando o outro lado não responde?”. É nas integrações que os prazos escorrem e as falhas se escondem. Por exemplo, a capacidade “estimar custo de reparo” pode ser uma API interna com tempo de resposta de até 3 segundos, versão fixa e comportamento definido quando o modelo está indisponível.

Use API síncrona quando o pedido precisa de resposta imediata. Use webhook ou fila quando o processamento demora e o outro lado avisa quando terminar. Use MCP quando quem consome a API é um agente de IA que precisa descobrir e usar ferramentas. Uma forma simples de diferenciar: API é o contrato; síncrono ou assíncrono é o ritmo; MCP é o padrão para agentes.

Conceito de interface de programação (anos 1960); REST definido por Roy Fielding (2000) e padrão de facto das APIs web.

Fielding, Architectural Styles and the Design of Network-based Software Architectures (2000); OpenAI Platform docs, API reference