Clicked Gallery

O que é uma API?

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

Usado numa frase

Engineering Notes · AI Systems

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

Os mesmos fatos, outra vibe — Modo slang 😎

O método Clicked

●○○

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.
●○○

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. 😎

Uma ideia rápida — muitas vezes é tudo de que você precisa.

●●○

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.
●●○

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. 😎

Quer mais? Um clique aprofunda.

●●●

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.
Deepest level reached.
●●●

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.
Deepest level reached.

Conceito novo? Um exemplo do dia a dia faz clicar — novas analogias quando quiser.

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