Guia da Documentação da API do FC Barcelona — Tudo que Você Precisa em 2026

Entendendo a Documentação da Barça API

A Barça API oferece duas formas de explorar a documentação: docs interativos com Scalar e um terminal no browser para exploração rápida.

Os Docs Interativos da API

Acesse /docs para a documentação completa OpenAPI com Scalar:

• Navegue por todos os endpoints com a lista completa de parâmetros
• Veja objetos de request e response com exemplos
• Envie requisições de teste diretamente do browser
• Entenda respostas de erro e status codes

Fazendo uma Requisição de Teste nos Docs

1. Acesse /docs
2. Clique no endpoint /api/squad
3. Clique em "Try it"
4. Opcionalmente adicione position=FW como query parameter
5. Clique em Send — você verá a resposta ao vivo da API real

Sem chave de API, sem configuração.

O Terminal Interativo

Para uma experiência mais prática, o terminal permite consultar a API via linha de comando no browser.

Comandos Disponíveis

/help              — Mostra todos os comandos
/squad             — Elenco completo
/squad FW          — Filtrar atacantes
/player <número>   — Jogador pelo número de camisa
/next-match        — Próxima partida
/calendar          — Calendário de jogos
/standings         — Classificação da La Liga
/scorers           — Artilheiros (LAL ou UCL)
/h2h <time>        — Confronto direto vs adversário
/lang pt-br        — Mudar para português
/clear             — Limpar terminal

Formato das Requisições

Todos os endpoints da Barça API são:

• Método HTTP: apenas GET
• URL base: https://api.fc-barcelona.app
• Formato de resposta: JSON com campo data
• Autenticação: Não necessária
• CORS: Habilitado para todas as origens

Envelope de Resposta Padrão

{
  "data": { ... },
  "meta": {
    "cached_at": "2026-03-21T12:00:00.000Z",
    "cache_expires_at": "2026-03-22T12:00:00.000Z"
  }
}

Respostas de Erro

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Jogador não encontrado"
  }
}

Exemplos de Código

JavaScript / TypeScript

const response = await fetch('https://api.fc-barcelona.app/api/squad');
const { data } = await response.json();

Python

import requests
response = requests.get('https://api.fc-barcelona.app/api/squad')
data = response.json()['data']

Comece a Explorar

Acesse os docs interativos ou abra o terminal — ambos são gratuitos, não precisam de configuração e conectam à API ao vivo.