Dados abertos
Para wikis, calculadoras, bots, sites de fã e vídeos: os dados do jogo em JSON, sem cadastro, sem chave, sem cookie e sem nenhum dado de pessoa. O acesso é o mesmo para todo mundo.
1. O que existe
/api/publico/v1/: o índice, com o endereço de tudo o que vem abaixo (use o endereço com a barra no fim)./api/publico/v1/armas: as armas, com família, elemento, tier, preço e atributos./api/publico/v1/especies: as espécies de monstrinho./api/publico/v1/mapas: as faixas de mapa da Guerra, com nível mínimo e máximo, tamanho e duração da rodada./api/publico/v1/idiomas/{idioma}.json: os nomes de armas, famílias, espécies e do Mundo traduzidos, em en, es, fr, de, it, tr, id, pl, ja, ko e zh-Hans. O português já vem nos outros endereços./api/publico/v1/mundo: a versão do conteúdo do Mundo e os endereços deconteudo.json(regiões, mapas, itens, NPCs, missões, chefões e insígnias) e demapas/{id}.json(cada mapa). Sem tabela de drop, chance, roteiro, equipe de batalha, encontro nem preço.- Imagens:
/assets/species-views/{id}.webp(cada monstrinho) e/assets/manifest.json(a posição de cada quadro e de cada arma).
O catalogo_versao do índice e a versao do Mundo mudam quando o conteúdo muda.
2. Como usar
Exemplos: curl https://powpow.com.br/api/publico/v1/armas ou, num site, fetch('https://powpow.com.br/api/publico/v1/especies').then(r => r.json()). Os endereços de /api/publico/v1/ têm CORS liberado para qualquer site. As imagens de /assets podem ser mostradas direto no seu site, mas o /assets/manifest.json não tem CORS: leia-o pelo servidor (curl, bot ou gerador de wiki), não pelo navegador.
- Não use query string (
?x=1): ela não muda a resposta. O servidor responde 404, e pela Cloudflare pode vir a cópia guardada sem ela. - Limite: 60 pedidos por minuto por endereço IP. Passou disso, a resposta é 429: espere um minuto.
- As respostas ficam guardadas por até 5 minutos (cabeçalho
Cache-Control). Guarde uma cópia e releia de hora em hora, não a cada visita do seu site. - Erro sempre em JSON:
{"erro":"nao_encontrado"},{"erro":"limite"}e{"erro":"inativo"}quando o Mundo está fechado. - A versão fica no caminho (
v1). Umav2que mude o formato será avisada aqui, e av1continua por pelo menos 90 dias depois dela.
3. Licença dos dados: CC BY 4.0
Os dados em JSON desta API (armas, espécies, mapas, idiomas e conteúdo do Mundo) estão sob a licença Creative Commons Atribuição 4.0 Internacional (CC BY 4.0).
- Pode copiar, redistribuir, adaptar e usar, inclusive comercialmente.
- Dê a atribuição PowPow · powpow.com.br · @matheuslape, com link para a licença, e indique se mudou alguma coisa (seção 3(a)(1) da licença).
- A CC BY 4.0 não licencia marca nem patente (seção 2(b)(2) da licença) e não cobre a arte do jogo: para a arte, veja a seção 4; para o nome e o logo, a seção 5.
4. Licença de fã da arte
- A arte em
/assetse a do kit de criadores e fãs pode ser usada em conteúdo sobre o PowPow (vídeo, live, imagem, site ou aplicativo de fã), inclusive com anúncio, com o crédito da seção 3. - Pode recortar e redimensionar. Não pode alterar nem combinar com outras marcas, em especial de aposta, cassino e criptoativos.
- Não pode vender a arte em si nem usá-la como arte de outro jogo.
- São condições contratuais dos Termos de Uso (seção 6), concedidas pelo criador do PowPow.
5. Marca
O nome PowPow e o logo podem ser citados e mostrados para falar do jogo. É proibido:
- aposta, rifa, sorteio, cassino, criptoativo ou token com itens, moedas, contas ou dados do PowPow;
- passar-se pelo PowPow ou prometer ganho em nome dele;
- usar o nome em produto, serviço, domínio ou canal que se confunda com o oficial.
6. Privacidade
A API não entrega nenhum dado de pessoa: nem apelido, nem e-mail, nem conta. Ela não usa cookie. O endereço IP de quem pede serve só ao limite de pedidos e aos registros de acesso do servidor, nos prazos da Política de Privacidade.
7. Mudanças e contato
Podemos mudar estas condições, e a data acima muda junto. Dúvidas: [email protected]. Para vídeo, live e site de fã, veja também as condições para criadores e fãs.
Voltar ao jogo criado por: @matheuslape