Documentação da API PyTrack

Autenticação

Gere uma chave em Configurações → API (plano Suprema ou superior). Lá também há um playground para testar a API ao vivo. Envie a chave no header Authorization:

Authorization: Bearer pytk_live_xxxxxxxxxxxx

Base URL

https://www.pytrack.com.br/api/v1

Limites

60 requisições por minuto por chave. Acima disso, retorna 429.

Endpoints

GET /me — seu perfil de aprendizado

Retorna XP, nível, progresso e habilidades do dono da chave. Ideal para badges e portfólios.

curl https://www.pytrack.com.br/api/v1/me \
  -H "Authorization: Bearer pytk_live_xxxxxxxxxxxx"

Resposta:

{
  "data": {
    "name": "Estevam",
    "headline": "Estudante de Backend Python",
    "level": "intermediario",
    "xp": 1240,
    "skills": ["Python", "FastAPI", "Pandas"],
    "github": "estevam5s",
    "modulesCompleted": 18,
    "profileUrl": "https://www.pytrack.com.br"
  }
}

GET /progress — seu progresso de aprendizado

Retorna módulos concluídos, XP, nível e atividades recentes. Ideal para sistemas de gestão de curso e relatórios.

curl https://www.pytrack.com.br/api/v1/progress \
  -H "Authorization: Bearer pytk_live_xxxxxxxxxxxx"

{
  "data": {
    "student": "Estevam",
    "xp": 1240,
    "level": "intermediario",
    "modulesCompleted": 18,
    "recent": [{ "moduleId": "...", "completedAt": "2026-06-10T..." }]
  }
}

GET /tracks — trilhas e cursos disponíveis

Lista as 17 trilhas da PyTrack com nível, plano, módulos, horas e tópicos. Ótimo para catálogos e integrações de LMS.

curl https://www.pytrack.com.br/api/v1/tracks \
  -H "Authorization: Bearer pytk_live_xxxxxxxxxxxx"

GET /ranking — ranking da comunidade

Top estudantes por XP. Use ?limit=10 (máx. 50).

curl "https://www.pytrack.com.br/api/v1/ranking?limit=10" \
  -H "Authorization: Bearer pytk_live_xxxxxxxxxxxx"

{
  "data": [
    { "position": 1, "name": "Ana", "level": "avancado", "xp": 5200 },
    { "position": 2, "name": "Bruno", "level": "intermediario", "xp": 3100 }
  ]
}

Exemplo de uso (JavaScript)

const res = await fetch("https://www.pytrack.com.br/api/v1/me", {
  headers: { Authorization: "Bearer pytk_live_xxxxxxxxxxxx" },
});
const { data } = await res.json();
console.log(`${data.name} — ${data.xp} XP, nível ${data.level}`);

Erros

• 401 — chave ausente, inválida ou revogada.
• 429 — limite de requisições excedido.

Precisa de um endpoint específico para sua integração? Fale com a gente.