Base de conhecimento aprofundada de TODAS as APIs públicas e autenticadas do Cartola FC (api.cartolafc.globo.com / api.cartola.globo.com). Use quando precisar consultar endpoints, estrutura de resposta, campos de dados, autenticação via X-GLB-Token, scouts, posições, clubes, mercado, ligas, times, rodadas, atletas ou qualquer integração com a API oficial do Cartola. Participante de teste premium - Paulinett Miranda (ID 13935277).
日本語に翻訳 name: cartola-api
description: Base de conhecimento aprofundada de TODAS as APIs públicas e autenticadas do Cartola FC (api.cartolafc.globo.com / api.cartola.globo.com). Use quando precisar consultar endpoints, estrutura de resposta, campos de dados, autenticação via X-GLB-Token, scouts, posições, clubes, mercado, ligas, times, rodadas, atletas ou qualquer integração com a API oficial do Cartola. Participante de teste premium - Paulinett Miranda (ID 13935277).
Cartola API - Knowledge Base
Base de conhecimento completa das APIs oficiais do Cartola FC.
Fonte: caRtola Wiki - Lista de links para API
Base URLs
A API migrou de domínio ao longo dos anos:
Atual (2024+): https://api.cartola.globo.comLegado: https://api.cartolafc.globo.com
Ambos podem funcionar. O sistema usa api.cartola.globo.com no cartolaApiService.js.
Participante de Teste (Premium)
Campo Valor Nome Paulinett Miranda Time ID 13935277Time Urubu Play F.C. Status Assinante Premium (Cartola PRO) Endpoint teste GET /time/id/13935277
Referências Detalhadas
Endpoints completos: Ver references/api-endpoints.md para lista completa de todos endpoints públicos e autenticadosSchemas de resposta: Ver references/response-schemas.md para estrutura JSON de cada endpoint
Quick Reference - Endpoints Mais Usados
Públicos (sem autenticação)
Endpoint Descrição GET /mercado/statusStatus do mercado, rodada atual, fechamento GET /atletas/mercadoTodos atletas disponíveis no mercado GET /atletas/pontuadosPontuação da rodada atual GET /atletas/pontuados/{rodada}Pontuação de rodada específica GET /time/id/{id}Dados do time (escalação atual) GET /time/id/{id}/{rodada}Dados do time em rodada específica GET /time/slug/{slug}Time por slug GET /times?q={query}Buscar times por nome GET /liga/{slug}Dados de uma liga pública GET /ligas?q={query}Buscar ligas por nome GET /clubesTodos os clubes do Brasileirão GET /rodadasLista das 38 rodadas GET /partidasPróximas partidas GET /partidas/{rodada}Partidas de rodada específica GET /esquemasFormações táticas disponíveis GET /mercado/destaquesJogadores mais escalados GET /pos-rodada/destaquesDestaques pós-rodada
Autenticados (requer X-GLB-Token)
Endpoint Descrição GET /auth/timeTime do usuário logado GET /auth/time/infoInfo detalhada do time logado GET /auth/ligasLigas do usuário logado GET /auth/liga/{slug}Liga específica (com dados privados) POST /auth/time/salvarSalvar escalação
Autenticação
Header: X-GLB-Token: <token>
O token é obtido via login Globo.com (OAuth). Para endpoints /auth/* é obrigatório.
Integração no Projeto
O serviço services/cartolaApiService.js implementa:
Retry com backoff exponencial (1s, 2s, 4s)
Cache via NodeCache (TTL 5min padrão)
Timeout de 15s
Validação de scout data
Detecção dinâmica de rodada atual
Métodos Disponíveis
import cartolaApi from '../services/cartolaApiService.js';
await cartolaApi.obterStatusMercado() // /mercado/status
await cartolaApi.obterTimesLiga(ligaId) // /liga/{id}
await cartolaApi.obterDadosTimeRodada(timeId, rodada) // /time/id/{id}/{rodada}
await cartolaApi.buscarTimePorNome(query, limit) // /times?q=
await cartolaApi.buscarTimePorId(timeId) // /time/id/{id}
await cartolaApi.buscarTimePorIdCompleto(timeId) // /time/id/{id} (raw)
await cartolaApi.coletarGolsLiga(ligaId, rodada) // Coleta gols via /atletas/pontuados
await cartolaApi.getRodadaStatus(rodada) // Status derivado do mercado
Mapeamentos Críticos
Posições (posicao_id)
ID Posição Abreviação 1 Goleiro GOL 2 Lateral LAT 3 Zagueiro ZAG 4 Meia MEI 5 Atacante ATA 6 Técnico TEC
Status do Mercado (status_mercado)
Código Status 1 Mercado aberto 2 Mercado fechado 4 Manutenção 6 Fim de temporada 15 Mercado em atualização
Scouts Principais
Sigla Significado Pontos G Gol +8.0 A Assistência +5.0 FT Finalização na trave +3.5 FD Finalização defendida +1.2 FF Finalização pra fora +0.8 FS Falta sofrida +0.5 PE Passes errados -0.3 I Impedimento -0.1 FC Falta cometida -0.3 GC Gol contra -3.0 CV Cartão vermelho -3.0 CA Cartão amarelo -1.0 SG Sem gol sofrido (goleiro/zagueiro) +5.0 DD Defesa difícil +3.0 GS Gol sofrido -1.0 DS Desarme +1.2 PP Pênalti perdido -4.0 DP Defesa de pênalti +7.0 PC Passe completo (>30) +0.3