Clicked Gallery

O que é uma API?

Subrayado en un documento técnico real. Explicado por Clicked.

Usado numa frase

The bank exposes account balances through a documented API rather than letting partners touch the database.

O leitor sublinhou uma palavra na documentação. O Clicked tornou o termo técnico «API» fácil de entender:

Explicado em três níveis

●○○

Overview

▾

Uma API, sigla de interface de programação de aplicações, é um conjunto de regras que deixa aplicativos de software diferentes conversarem entre si e trocarem dados. Um programa pede num formato combinado e o outro responde num formato combinado, e nenhum precisa saber como o outro funciona por dentro. Quase tudo online que fala com qualquer outra coisa está fazendo isso por uma API.

●●○

Detail

▾

Uma API é um jeito publicado de um software pedir a outro que faça algo: mande uma requisição neste formato, receba uma resposta naquele formato. Um serviço de meteorologia pode prometer que, se você mandar o nome de uma cidade, ele devolve a previsão de hoje. O aplicativo que pergunta nunca precisa saber como a previsão foi produzida, só como pedi-la. Essa separação é o ponto inteiro, porque deixa os dois lados mudarem de forma independente. O serviço de meteorologia pode reconstruir o sistema inteiro sem quebrar cada aplicativo que o usa, desde que a API continue igual. O dono também decide quais requisições são permitidas, quem pode fazê-las e com que frequência. Se essas regras mudam de forma incompatível, aplicativos antigos param de funcionar, então as empresas normalmente lançam uma versão nova em vez de alterar a antiga. Sistemas modernos de IA se apoiam em APIs o tempo todo, seja checando o tempo, lendo a sua agenda ou reservando um voo.

●●●

Analogy

▾

O cardápio de um restaurante. Ele lista exatamente o que você pode pedir e o que chega se pedir, e você nunca vê a cozinha, conhece o chef ou aprende a receita. A cozinha pode trocar os fornos ou os fornecedores sem lhe avisar, e o seu pedido continua funcionando, porque o cardápio é o acordo. Peça algo fora do cardápio e a resposta é simplesmente não.

Explicações de IA podem conter erros · Não é aconselhamento profissional

Os mesmos fatos, outra vibe — Modo slang 😎

●○○

Overview

▾

Uma API é como um programa pede algo a outro sem nenhum dos dois fuçar na vida do outro. Peça no formato que eles querem, receba de volta o que prometeram, e não se meta. Basicamente a internet inteira se sustenta nesse único arranjo, repetido alguns bilhões de vezes por segundo. 😎

●●○

Detail

▾

Cada aplicativo do seu celular passa o dia implorando coisas a outros programas que ele mesmo não sabe fazer. Um site de preços de voo não tem avião nenhum; ele pede a cada companhia as tarifas de hoje, costura as respostas e lhe entrega uma listinha arrumada como se tivesse feito algo genial. A companhia decide quais consultas vai atender, de quem, e quantas antes de parar de atender. Ninguém entrega o banco de dados a ninguém. Peça no formato publicado, receba o formato prometido, fique fora da cozinha. E quando o formato precisa mudar, ninguém edita o que está no ar, porque isso quebra todo aplicativo que depende dele no mesmo instante. Publicam uma segunda versão e deixam a primeira se aposentar com dignidade. 😎

●●●

Analogy

▾

Uma máquina de salgadinhos. Você aperta B4, sai o salgadinho, e em nenhum momento você entra na máquina para remexer. Podem trocar o fornecedor, refazer a fiação, reabastecer de cabeça para baixo, e B4 continua significando salgadinho. Aperte um botão que não existe e você não recebe nada: sem salgadinho, sem explicação, sem reembolso.

Explicações de IA podem conter erros · Não é aconselhamento profissional

Definição formal — O mesmo termo, explicado da forma habitual

Uma API, ou interface de programação de aplicações, é um contrato definido que especifica as requisições que um sistema de software aceita e as respostas que devolve, permitindo a interoperação sem exposição da implementação interna. Esse desacoplamento permite a evolução independente de provedor e consumidor, sujeita à disciplina de versionamento, e fornece a fronteira na qual autenticação, autorização e limitação de taxa são aplicadas.

Quer que o Clicked explique termos como «API» direto no seu navegador, até em PDFs?

Adicionar ao Chrome — Grátis

50 explicações grátis · Sem cartão de crédito

Mais da galeria

O que significa uma API idempotente?

Por que dez cliques cobram uma vez só — a propriedade que torna as retentativas seguras.

O que é uma camada de abstração?

Simples por cima, complexidade escondida por baixo — e trocável sem quebrar nada.

O que são agentes de IA?

IA que age em vez de só responder: o ciclo planejar-fazer-conferir, e por que o ciclo é também o risco.

O que é dívida técnica?

Atalhos e sistemas envelhecendo que mandam a conta para o futuro — principal, juros e pagamento.

O que é geração aumentada por recuperação (RAG)?

Faça a IA responder a partir dos seus documentos — primeiro a busca, depois a resposta, com as fontes à vista.

O que é edge computing?

Fazer o trabalho no dispositivo em vez de num data center — e as três situações que exigem isso.