Revisado em
Toda integração é um contrato: o sistema do fornecedor aceita, devolve, cobra e responde em certo tempo, e alguém responde quando isso falha. Este curso mostra como ler esse contrato sem abrir o código, o que exigir antes de assinar e como cobrar depois: o arquivo OpenAPI como anexo, a guarda da chave de acesso, o limite de uso e o preço das APIs de IA em outubro de 2026, o erro padronizado, a escolha entre REST e GraphQL, a descontinuação de versões, o teste de contrato e a latência do SLA. As fontes ficam no rodapé de cada capítulo, com data.
Ao final você conduz a conversa com o fornecedor de API em vez de assistir a ela. Sabe o que perguntar sobre disponibilidade, limite de uso, preço e teto de gasto; reconhece no relatório qual falha é sua e qual entra no SLA; exige o arquivo OpenAPI e o teste de contrato como critério de aceite; e escreve as cláusulas de descontinuação e de latência que protegem a operação quando o fornecedor muda.
O percurso linear dos 12 capítulos é o caminho completo. A Rota Executiva passa pelos sete capítulos de contrato, custo e risco e dispensa o código; a de Produto e Projeto termina no critério de aceite da integração.
CEO, CFO, diretoria e conselho, sem código
Conduzir a reunião com o fornecedor e aprovar um contrato de API com SLA, limite de uso, preço por chamada, teto de gasto e plano de descontinuação.
Gerente de produto, PMO e compras técnicas
Escrever o critério de aceite de uma integração e conferir a entrega contra o arquivo OpenAPI e o teste de contrato.
Quem desenvolve ou desenha a arquitetura da integração
Os 12 capítulos na ordem, com o bloco "Para quem implementa" de cada um: o mesmo contrato visto do lado de quem escreve o código.
A API é um contrato entre empresas, e o documento que a descreve pode virar anexo do pedido de compra.
A API vista como contrato entre empresas: o que o sistema do fornecedor aceita, devolve, cobra e em quanto tempo, e quem responde quando falha.
O que exatamente estou comprando quando assino uma integração? Um contrato técnico: o que o sistema do fornecedor aceita, o que devolve, quanto cobra e em quanto tempo responde. Quando esse contrato é descumprido, alguém responde por isso, e você precisa saber quem antes de assinar.
O que o sistema aceita, devolve, cobra e em quanto tempo responde.
Cada cláusula tem um responsável quando a chamada falha.
Preço por chamada sem limite de uso nem SLA deixa a venda descoberta.
Agentes de IA usam a API pelo MCP e dependem do mesmo contrato claro.
API (interface de programação de aplicações) é a porta pela qual um sistema pede algo a outro. Cada porta específica, como "calcular frete" ou "emitir nota fiscal", se chama endpoint, o endereço que executa uma única tarefa. O conjunto de endpoints, com as regras de uso, forma o contrato técnico. Ele se parece com o contrato da adquirente de cartão: quem pode transacionar, quais limites valem, qual taxa se aplica e como contestar um erro. A diferença é que quem lê e cumpre as cláusulas é uma máquina.
Página de referência da API da Stripe, com o menu de recursos à esquerda, a explicação da API ao centro e exemplos de chamada à direita.
Exemplo hipotético: uma varejista integra a calculadora de frete de uma transportadora. Na sexta-feira da promoção, o volume de pedidos triplica, a transportadora passa a recusar as chamadas e o carrinho mostra "frete indisponível" por quatro horas. O contrato comercial falava em preço por consulta e não dizia nada sobre limite de uso, tempo de resposta ou multa. A equipe técnica fez o que estava combinado; a venda se perdeu na cláusula que ninguém escreveu.
| Cláusula | Pergunta | Onde o curso trata |
|---|---|---|
| Escopo | Quais operações estão incluídas e existe um documento OpenAPI que as descreve? | OpenAPI e documentação |
| Disponibilidade | Qual o SLA (acordo de nível de serviço): quanto tempo no ar por mês e qual crédito eu recebo se ele falhar? | Erros e velocidade |
| Limite de uso | Quantas chamadas por minuto cabem no plano e o que acontece na seguinte? | Limite de uso |
| Preço | Quanto custa cada chamada, há teto de gasto e por quanto tempo o preço está garantido? | Limite de uso |
| Mudança | Com quanto prazo o fornecedor avisa uma mudança que quebra a integração? | Versionamento |
| Acesso | Como a chave é emitida, guardada e revogada numa emergência? | Autenticação |
| Suporte | Como o erro é comunicado e qual identificador eu cito no chamado? | Erros |
Use a tabela como pauta da primeira reunião técnica com o fornecedor.
Quatro estilos dividem o mercado em outubro de 2026. REST organiza a API em recursos com endereço próprio e continua sendo o padrão das APIs públicas. GraphQL deixa o cliente escolher os campos de cada consulta e rende mais em telas que juntam muitos dados. gRPC e tRPC servem à conversa entre sistemas internos do mesmo time, com mensagens rápidas e tipadas. Este curso se concentra em REST e GraphQL, porque são os dois que um parceiro externo costuma consumir.
Na dúvida, comece por REST com OpenAPI: é o formato que parceiros, ferramentas e agentes de IA leem sem combinação prévia.
Há um consumidor novo na fila: o agente de IA, programa que decide sozinho quais ferramentas usar para cumprir uma tarefa. Ele chama APIs pelo Model Context Protocol (MCP), padrão aberto cuja especificação vigente é de 28 de julho de 2026. A pergunta nova do contrato é quem autorizou o agente a chamar o quê.
Página da especificação do Model Context Protocol na versão 2026-07-28, com o menu de seções à esquerda e a visão geral do protocolo ao centro.
Numa pesquisa da Salt Security, fornecedora de segurança de APIs, com mais de 380 respondentes, divulgada em 13/10/2026, 86,4% tinham ao menos um agente em operação e só 12,5% conseguiam rastrear de ponta a ponta, sempre, o caminho de todos os seus agentes. A governança de agentes ainda corre atrás do uso.
Comunicado da Salt Security de 13 de outubro de 2026, com a manchete de que quase metade das empresas relatou uma ação não autorizada de agente de IA, a pesquisa com mais de 380 profissionais e o dado de 49,8%.
API também é receita. O relatório State of the API 2025, da Postman, ouviu mais de 5.700 pessoas entre desenvolvedores, arquitetos e executivos: 65% das organizações geram receita com seus programas de API, e só 24% dos desenvolvedores desenham APIs pensando em agentes de IA. Tratar a API como produto, com dono, preço e indicador de uso, vale tanto para quem vende quanto para quem compra.
Um formato de resposta igual em todas as chamadas poupa o cliente de adivinhar onde estão os dados, a paginação e o erro. É a primeira cláusula técnica que vale pedir ao fornecedor:
{
"data": [{ "id": "ped_123", "status": "pago", "total": 189.9 }],
"meta": {
"requestId": "req_8f2c",
"page": 1,
"perPage": 20,
"total": 312
}
}Escolha uma integração que sua empresa usa ou pretende contratar. Preencha as sete perguntas da tabela com o que está documentado. Marque o que falta e anote quem precisa responder antes da aprovação.
Endereço, verbo e código de status contam o que aconteceu em cada chamada; com eles você lê o relatório do fornecedor e cobra o erro certo.
O arquivo OpenAPI descreve cada chamada de um jeito que a máquina confere; anexado ao contrato, vira o critério de aceite da entrega.
Documentação ruim custa semanas de integração e chamados; as cinco partes que medem a qualidade e o cuidado extra com agentes de IA.
Chave, crachá ou delegação: quem pode chamar a API, onde a chave fica guardada e quanto custa quando ela vaza.
Limite de uso, teto de gasto e preço por chamada como cláusulas comerciais, com as cotas e os reajustes das APIs de IA em outubro de 2026.
Validação na porta e erro padronizado pela RFC 9457: o formato que diz qual campo falhou, se vale tentar de novo e o que citar no chamado.
GraphQL acelera telas que juntam muitos dados e complica o parceiro que só quer cache e custo previsível; os critérios para decidir.
Consulta, alteração e assinatura no GraphQL, e o limite de profundidade e de custo que precisa entrar no contrato.
O que conta como mudança que quebra, quanto prazo os grandes fornecedores dão e a cláusula de descontinuação que vale negociar.
Teste unitário, de integração e de contrato: o que cada um pega, o que deixa passar, e as ferramentas Postman, Bruno e Hoppscotch.
Medir com p95, achar a causa da lentidão, usar cache sem expor dado de cliente e escrever a cláusula de latência do SLA.
Plataforma de visibilidade algorítmica com análises contínuas em ChatGPT, Gemini, Claude e Perplexity. R$ 99/mês nos primeiros 3 meses com cupom ALE99. Ideal para aplicar o que você aprendeu em API Design: REST, GraphQL e o contrato com o fornecedor.
Sem cartão para começar · cancele quando quiser · cupom ativo por 3 meses consecutivos
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Cursos do portal que aprofundam ou complementam o que você estudou aqui.
Seleção automática baseada nos tópicos, audiência e jornada desta página.
Páginas de referência do site sobre o mesmo assunto.
Usamos cookies para medir o uso do site, melhorar os cursos e, se você aceitar, medir anúncios. Política de privacidade