Construa para quem joga.
A API pública lê e escreve bibliotecas, avaliações, listas, jornadas e o catálogo de jogos. O Arcade leva aos jogadores do uloggd o jogo de navegador que você hospeda.
curl https://uloggd.com/api/v1/me \
-H "Authorization: Bearer ulg_live_…"
// 200
{
"key": { "scopes": ["library.read"] },
"owner": { "username": "ada" }
}A API para o que acontece no uloggd, o Arcade para o seu jogo
- Conhecer a API
API pública
Leia e escreva bibliotecas, avaliações, listas, jornadas e o catálogo, com uma chave que nunca pode mais do que a sua conta.
- PréviaConhecer o Arcade
Arcade
Publique um jogo de navegador que você hospeda. O uloggd lista o jogo, abre o seu site para quem joga e entrega uma identidade verificada a cada jogador que aceitar.
Do bot da sua comunidade ao seu próprio app
Bots para a sua comunidade
Mostre no Discord, no Twitch ou onde for o que alguém está jogando, a última avaliação ou a biblioteca, pelo nome de usuário.
Painéis e estatísticas
Leia o histórico, as jornadas e as notas e transforme em gráficos, retrospectivas ou planilhas.
Widgets para streams e sites
O jogo atual na tela da live, a lista de favoritos no seu site pessoal, sempre atualizados.
Importações e sincronia
Com as permissões de escrita, registre jogos, sessões e listas a partir das suas próprias ferramentas.
Três passos até a primeira chamada
- Passo 1
Crie um aplicativo
No portal, com nome, ícone e descrição. Cada conta pode ter até 10.
- Passo 2
Escolha as permissões
Só o que o app precisa: ler a biblioteca, escrever avaliações, ler o catálogo.
- Passo 3
Gere a chave e chame a API
A chave aparece uma vez. Daí é uma requisição HTTP como outra qualquer.
Tudo que o site tem, pela API
Cada recurso tem sua página na documentação, com endpoints, permissões e exemplos.
Nunca mais do que o dono
Uma chave roda como a conta que a criou. As mesmas regras do site decidem o que ela pode fazer.
Limites claros
Cada resposta diz quanto ainda cabe na janela e quando ela renova.
Um formato só
Coleções respondem
{ data, page }, recursos{ data }e falhas{ error }. Sem surpresas.
Leve o seu jogo de navegador a quem joga no uloggd
Você hospeda o jogo no seu próprio site, em HTTPS. O uloggd lista o jogo, abre o seu endereço numa página feita só para ele e, quando o jogador aceita, entrega ao jogo uma identidade assinada pelo uloggd.
Prévia Na prévia, só contas convidadas publicam. Ao ativar o Arcade num aplicativo, o uloggd confere o resto: verificação em duas etapas, e-mail verificado, conta com pelo menos 30 dias, 18 anos ou mais e o aceite dos Termos do Arcade para Desenvolvedores. A documentação, o SDK e o simulador são abertos a todos.
npm install @uloggd/arcade-sdk
import { createArcadeSDK } from "@uloggd/arcade-sdk";
const arcade = createArcadeSDK({
appId: "ID_DO_SEU_APLICATIVO",
mockWhenStandalone: true,
});
await arcade.ready();
await arcade.commands.authorize({ scopes: ["identify"] });No seu site
Uma origem HTTPS por jogo, na prática um subdomínio. O uloggd nunca hospeda, copia nem repassa os arquivos do jogo.
Um SDK pequeno
O
@uloggd/arcade-sdkrecebe o contexto, pede o consentimento do jogador, entra em tela cheia e avisa quando o jogo vai fechar.Identidade verificada
Com o aceite do jogador, o jogo recebe um id que só vale para ele e um apelido, e o seu servidor confere o token com as chaves públicas do uloggd. Nunca o e-mail, a conta ou a idade.
Revisado antes de chegar aos jogadores
Toda página da loja e toda URL nova passa por um moderador nomeado. Os jogadores só veem o que foi aprovado.
Do primeiro build à revisão
Cada guia traz exemplos e as regras que o portal e a revisão aplicam.
- Hospedagem
- O frame
- SDK
- Identidade
- Verificação em outras linguagens
- Eventos de dados
- Testes
- Política de revisão
- Deveres de privacidade
- Engines
Teste no simulador e no seu computador
Aberto em localhost, o SDK roda offline, com jogador e tokens falsos. Para ver o jogo dentro do uloggd, aponte a URL de desenvolvimento do portal para o seu localhost ou para um túnel HTTPS: só você vê, por 24 horas.
Regras para todo jogador
Na prévia, só joga quem está conectado e tem 16 anos ou mais. Todo jogo tem classificação indicativa de L a 16, e a v1 não tem compras nem anúncios.
SDK aberto, no npm
@uloggd/arcade-sdktem licença MIT e nenhuma dependência. O uloggd nunca serve o SDK aos jogos: ele vai junto com o seu, empacotado ou como um arquivo no seu próprio site.
Pronto para começar?
Crie seu primeiro aplicativo em menos de um minuto. O mesmo aplicativo serve à API e, com o convite da prévia, ao Arcade.