O que é API e Como Funciona? Guia Completo e Atualizado 2026

A forma mais comum de consumir uma API é usando fetch em JavaScript. Veja um exemplo de como buscar dados de clima de uma API REST:

// 1. Fazer a requisição GET para o endpoint da API
const response = await fetch(
  'https://api.openweathermap.org/data/2.5/weather?q=São Paulo&appid=SUA_API_KEY&units=metric&lang=pt_br'
);

// 2. Converter a resposta para JSON
const data = await response.json();

// 3. Usar os dados retornados
console.log(data.name);           // "São Paulo"
console.log(data.main.temp);      // 28.5
console.log(data.weather[0].description); // "céu limpo"

Nesse exemplo, o endpoint é a URL completa para onde enviamos a requisição. O parâmetro appid é a API Key que identifica nossa aplicação. A resposta vem em JSON, um formato leve e fácil de manipular.

Cada API define seus próprios endpoints, parâmetros e formatos de resposta. Por isso, ler a documentação é o primeiro passo antes de integrar qualquer API.

Existem quatro maneiras principais pelas quais as APIs podem funcionar, dependendo de quando e por que foram criadas:

No GraphQL, o cliente define exatamente quais campos quer receber. Compare a diferença com REST:

# Em vez de GET /users/octocat/repos (que retorna TUDO),
# pedimos apenas o que precisamos:

query {
  user(login: "octocat") {
    name
    repositories(first: 3, orderBy: { field: STARGAZERS_COUNT, direction: DESC }) {
      nodes {
        name
        stargazerCount
        description
      }
    }
  }
}

{
  "data": {
    "user": {
      "name": "The Octocat",
      "repositories": {
        "nodes": [
          { "name": "Hello-World", "stargazerCount": 2500, "description": "My first repository" },
          { "name": "Spoon-Knife", "stargazerCount": 1200, "description": "Fork testing repo" },
          { "name": "git-consortium", "stargazerCount": 800, "description": null }
        ]
      }
    }
  }
}

Com REST, você precisaria de múltiplas requisições (uma para o usuário, outra para os repos) e receberia dezenas de campos desnecessários. O GraphQL resolve isso em uma única chamada.

O que é um Endpoint?

Os endpoints são os pontos de contato finais no sistema de comunicação da API — são URLs específicas onde informações são enviadas e recebidas. Cada endpoint corresponde a um recurso ou ação no servidor.

GET    /api/v1/products          → Lista todos os produtos
GET    /api/v1/products/123      → Detalhes do produto 123
POST   /api/v1/products          → Criar novo produto
PUT    /api/v1/products/123      → Atualizar produto 123
DELETE /api/v1/products/123      → Remover produto 123
GET    /api/v1/products?category=eletrônicos&sort=price  → Filtrar e ordenar

Endpoints são fundamentais para segurança (são pontos vulneráveis a ataques) e performance (endpoints de alto tráfego podem causar gargalos).

O que é um API Gateway?

Um API Gateway é uma camada de gerenciamento que fica entre os clientes e os serviços de backend. Ele centraliza tarefas como:

• Autenticação e autorização de usuários
• Rate limiting (controle de taxa de requisições)
• Balanceamento de carga entre servidores
• Cache de respostas frequentes
• Monitoramento, logs e análise de uso
• Transformação de dados entre formatos

Exemplos: Amazon API Gateway, Kong, Nginx, Apigee.

As integrações de API são componentes que atualizam dados automaticamente entre clientes e servidores, eliminando trabalho manual e erros humanos. Exemplos do dia a dia:

• Sincronização de fotos: Suas fotos são enviadas automaticamente para a nuvem (Google Photos, iCloud) via API
• Fuso horário: Seu celular atualiza a hora automaticamente quando você viaja
• E-commerce: Quando um produto é vendido no site, o estoque é atualizado no ERP automaticamente
• Marketing: Quando alguém preenche um formulário, o lead é criado no CRM via API
• Pagamentos: Notificações de webhook informam seu sistema quando um pagamento é confirmado

Webhooks: APIs "ao Contrário"

Um webhook é uma função de retorno de chamada baseada em HTTP que inverte o fluxo normal: em vez do cliente ficar perguntando "tem novidade?", o servidor notifica o cliente quando algo acontece.

// O Stripe envia este POST automaticamente para seu servidor:
{
  "type": "payment_intent.succeeded",
  "data": {
    "object": {
      "id": "pi_3abc123",
      "amount": 15000,
      "currency": "brl",
      "status": "succeeded",
      "customer": "cus_xyz789"
    }
  }
}

Para integrar uma API em seu projeto, siga estas etapas:

1. Encontre a API adequada em marketplaces como RapidAPI, Public APIs ou diretamente nos sites dos provedores (Google, AWS, Stripe)
2. Obtenha uma chave de API criando uma conta verificada com o provedor
3. Leia a documentação para entender os endpoints disponíveis, parâmetros, formatos de dados e limites de uso
4. Configure o cliente HTTP — pode ser o fetch nativo do JavaScript, a biblioteca axios, ou ferramentas como Postman para testes
5. Integre no seu código seguindo as instruções específicas da API, tratando erros e implementando retry logic

// Buscar endereço pelo CEP usando a API gratuita ViaCEP
async function buscarEndereco(cep) {
  try {
    const response = await fetch(`https://viacep.com.br/ws/${cep}/json/`);
    
    if (!response.ok) {
      throw new Error(`Erro HTTP: ${response.status}`);
    }
    
    const endereco = await response.json();
    
    if (endereco.erro) {
      throw new Error('CEP não encontrado');
    }
    
    return {
      rua: endereco.logradouro,
      bairro: endereco.bairro,
      cidade: endereco.localidade,
      estado: endereco.uf,
    };
  } catch (error) {
    console.error('Erro ao buscar CEP:', error.message);
    return null;
  }
}

// Uso:
const endereco = await buscarEndereco('01001000');
// { rua: "Praça da Sé", bairro: "Sé", cidade: "São Paulo", estado: "SP" }

As duas abordagens de arquitetura que mais utilizam APIs remotas são:

SOA (Arquitetura Orientada a Serviços)

A SOA surgiu como aprimoramento das aplicações monolíticas: em vez de um único sistema fazer tudo, funções são fornecidas por aplicações separadas conectadas por um barramento de serviços (ESB). Embora simplifique a arquitetura monolítica, pode trazer complexidade nas interações entre componentes.

Microsserviços

Evoluem o conceito da SOA: cada serviço é totalmente independente, comunica-se via APIs RESTful, e pode ser substituído, atualizado ou escalado sem afetar outros serviços. Essa arquitetura é ideal para aplicações em nuvem que precisam de escalabilidade dinâmica.

O uso de APIs RESTful permite — e até estimula — a entrega mais rápida de novos recursos e atualizações. Cada serviço pode usar tecnologias diferentes, desde que respeite o contrato da API.

Monolítico vs SOA vs Microsserviços