API pública do KoliseuOT

Construa em cima do Koliseu.

Uma API REST somente-leitura, autenticada por token, com dados de personagem e de guild de cada mundo. Respostas em JSON, paginação previsível e um formato de erro só. Pegue um token, escolha o mundo e comece.

Ler a documentação Pedir um token

Somente leitura · Bearer token · Rate limit por token · Legacy e Season

O que a API entrega

Quatro endpoints GET. Todos aceitam ?world= e devolvem o mesmo envelope de sucesso e de erro.

Detalhes do personagem

GET /api/character/details

Level, vocação, skills, outfit, town, guild, tempo online e as últimas mortes de um personagem.

escopo public:read

Guild e roster

GET /api/guild/{name}

Dados da guild (level, MOTD, tag, logo, dono) e a lista paginada de membros com rank e status online.

escopo public:read

Inventário

GET /api/character/inventory

Itens equipados e das mochilas, paginados. Não cobre depot, inbox nem stash.

escopo character:read

Histórico da loja

GET /api/character/store-history

Compras e créditos de coins do personagem, do mais recente para o mais antigo.

escopo character:read

Para quem é

Se você mantém alguma ferramenta em volta do servidor, a API existe pra te tirar do scraping.

Bot de Discord

Comando !char que responde level, vocação e guild direto no canal da sua comunidade.

Site de guild

Roster sempre atualizado, com rank, level e quem está online agora.

App de status

Painéis de progresso, comparativos de skill e acompanhamento de temporada.

Ferramenta da comunidade

Rankings paralelos, planilhas, overlays de stream — qualquer coisa que precise de dado do servidor.

Mundos

Personagens e guilds vivem em mundos separados, então todo endpoint aceita o parâmetro opcional world, por slug (legacy, season) ou por id numérico. Sem o parâmetro, a resposta vem do Legacy. O mundo resolvido é sempre ecoado no corpo da resposta, então dá pra logar exatamente de onde o dado veio.

O mesmo nome de guild pode existir em mais de um mundo — sempre mande o world quando importar.

Token e escopos

Todo request precisa do header Authorization. Tokens são emitidos manualmente pela equipe — conte o que você vai construir e a gente libera o escopo certo.

Como pedir

Abra um ticket no Discord dizendo o nome do projeto, o que ele faz e quais dados precisa. A equipe gera o token e te entrega uma única vez — guarde em local seguro, porque o servidor só armazena o hash e não consegue te mostrar de novo.

Authorization: Bearer kol_<64 caracteres hex>

Abrir ticket no Discord

Escopos

public:read

Público

Dados que qualquer visitante já vê no site: personagem e guild. É o escopo padrão de um token novo.

character:read

Privilegiado

Inclui tudo de public:read e libera inventário e histórico da loja. Só é concedido para integrações com propósito claro.

Cada token também tem um tier de rate limit. Estourou o limite, a resposta é 429 com Retry-After — respeite o header e você nunca é bloqueado.

Primeira chamada

Troque o token pelo seu e o nome pelo do personagem.

curl -H "Authorization: Bearer kol_xxxxxxxx..." \
  "https://koliseuot.com.br/api/character/details?name=Bubble&world=legacy"

Resposta: { success, world, data } — e { error, message } quando algo dá errado.

Seu acesso

Entre na sua conta para ver aqui o status do seu acesso à API. Ainda não tem token? Peça pelo Discord — a emissão é manual e leva menos de um dia útil.

Entrar Pedir token