Uma interface de programação de aplicações conecta software
A interface oferece a um sistema uma maneira conhecida de solicitar algo de outro sistema. Ela também define o resultado que é retornado.
Uma interface de programação de aplicações, ou API, é um conjunto definido de regras que permite que sistemas de software se comuniquem e troquem dados, recursos ou funcionalidades.
Uma requisição segue um contrato acordado
Imagine uma aplicação que precisa de um status de entrega de outro serviço. Ela envia uma requisição para um endpoint definido usando as informações esperadas. O serviço verifica a requisição e retorna uma resposta em um formato que ambos os lados entendem.
Esse contrato permite que cada sistema mude internamente enquanto mantém a conexão acordada estável. Quando o contrato muda, as equipes precisam se coordenar para que as requisições existentes continuem funcionando.
APIs apoiam reutilização e separação
Uma API pode expor uma capacidade existente em vez de fazer outra aplicação construí-la novamente. Um sistema pode fornecer registros de clientes, agendamento ou status de pagamento para várias aplicações aprovadas.
O acesso deve ser deliberado. A API precisa de permissões claras, tratamento seguro de requisições incorretas e documentação útil para as pessoas ou sistemas que dependem dela.
Termos de API
- Requisição
- Uma mensagem solicitando informações ou uma ação de outra aplicação ou serviço.
- Resposta
- O resultado retornado depois que um sistema de software recebe e processa uma requisição.
- Endpoint
- Um local definido através do qual um tipo específico de requisição é enviado.
O que uma conexão útil define
A ação disponível
A interface declara quais informações podem ser solicitadas ou alteradas.
O formato esperado
Ambos os sistemas concordam sobre a estrutura e o significado da requisição e da resposta.
A regra de acesso
Verificações de autenticação e permissão limitam quem ou o que pode usar a conexão.
Perguntas sobre interfaces de programação de aplicações
API significa interface de programação de aplicações. Descreve regras que software usa para solicitar e trocar informações ou ações.
Normalmente não. Uma interface de usuário é projetada para uma pessoa. Uma API é projetada para software se comunicar com outro software, embora pessoas definam e gerenciem essa comunicação.
APIs permitem que sistemas separados compartilhem dados ou capacidades aprovados através de uma conexão definida. Isso pode reduzir trabalho repetido e manter responsabilidades separadas entre aplicações.
Guias relacionados do glossário
Conecte o trabalho do qual sua equipe depende
Os apps do Caffeine rodam no Internet Computer, uma rede pública feita para isso.