Construye para quienes juegan.
La API pública lee y escribe bibliotecas, reseñas, listas, recorridos y el catálogo de juegos. Arcade lleva a los jugadores de uloggd el juego de navegador que alojas tú.
curl https://uloggd.com/api/v1/me \
-H "Authorization: Bearer ulg_live_…"
// 200
{
"key": { "scopes": ["library.read"] },
"owner": { "username": "ada" }
}La API para lo que pasa en uloggd, Arcade para tu juego
- Conocer la API
API pública
Lee y escribe bibliotecas, reseñas, listas, recorridos y el catálogo, con una clave que nunca puede más que tu cuenta.
- Vista previaConocer Arcade
Arcade
Publica un juego de navegador que alojas tú. uloggd lo lista, abre tu sitio para quien juega y entrega una identidad verificada a cada jugador que acepte.
Del bot de tu comunidad a tu propia app
Bots para tu comunidad
Muestra en Discord, Twitch o donde sea lo que alguien está jugando, su última reseña o su biblioteca, por nombre de usuario.
Paneles y estadísticas
Lee el historial, los recorridos y las notas y conviértelos en gráficos, resúmenes u hojas de cálculo.
Widgets para streams y sitios
El juego actual en tu stream, tu lista de favoritos en tu sitio, siempre al día.
Importaciones y sincronía
Con permisos de escritura, registra juegos, sesiones y listas desde tus propias herramientas.
Tres pasos hasta la primera llamada
- Paso 1
Crea una aplicación
En el portal, con nombre, ícono y descripción. Cada cuenta puede tener hasta 10.
- Paso 2
Elige sus permisos
Solo lo que la app necesita: leer la biblioteca, escribir reseñas, leer el catálogo.
- Paso 3
Genera la clave y llama a la API
La clave aparece una vez. Desde ahí es una petición HTTP como cualquier otra.
Todo lo que tiene el sitio, por la API
Cada recurso tiene su página en la documentación, con endpoints, permisos y ejemplos.
Nunca más que su dueño
Una clave actúa como la cuenta que la creó. Las mismas reglas del sitio deciden lo que puede hacer.
Límites claros
Cada respuesta dice cuánto queda en la ventana y cuándo se renueva.
Un solo formato
Las colecciones responden
{ data, page }, los recursos{ data }y los fallos{ error }. Sin sorpresas.
Lleva tu juego de navegador a quienes juegan en uloggd
Alojas el juego en tu propio sitio, con HTTPS. uloggd lo lista, abre tu dirección en una página hecha solo para él y, cuando el jugador acepta, le entrega al juego una identidad firmada por uloggd.
Vista previa Durante la vista previa, solo publican las cuentas invitadas. Al activar Arcade en una aplicación, uloggd comprueba el resto: verificación en dos pasos, correo verificado, una cuenta con al menos 30 días, 18 años o más y la aceptación de los Términos de Arcade para Desarrolladores. La documentación, el SDK y el simulador están abiertos a todos.
npm install @uloggd/arcade-sdk
import { createArcadeSDK } from "@uloggd/arcade-sdk";
const arcade = createArcadeSDK({
appId: "ID_DE_TU_APLICACION",
mockWhenStandalone: true,
});
await arcade.ready();
await arcade.commands.authorize({ scopes: ["identify"] });En tu sitio
Un origen HTTPS por juego, en la práctica un subdominio. uloggd nunca aloja, copia ni reenvía los archivos del juego.
Un SDK pequeño
@uloggd/arcade-sdkrecibe el contexto, pide el consentimiento del jugador, entra en pantalla completa y avisa cuando el juego va a cerrarse.Identidad verificada
Cuando el jugador acepta, el juego recibe un id propio y un apodo, y tu servidor comprueba el token con las claves públicas de uloggd. Nunca el correo, la cuenta ni la edad.
Revisado antes de llegar a los jugadores
Cada página de la tienda y cada URL nueva pasa por un moderador con nombre. Los jugadores solo ven lo aprobado.
Del primer build a la revisión
Cada guía trae ejemplos y las reglas que aplican el portal y la revisión.
- Alojamiento
- El frame
- SDK
- Identidad
- Verificación en otros lenguajes
- Eventos de datos
- Pruebas
- Política de revisión
- Deberes de privacidad
- Motores
Prueba en el simulador y en tu computadora
Abierto en localhost, el SDK funciona sin conexión, con un jugador y tokens falsos. Para ver el juego dentro de uloggd, apunta la URL de desarrollo del portal a tu localhost o a un túnel HTTPS: solo tú lo ves, durante 24 horas.
Reglas para todo jugador
Durante la vista previa, solo juega quien inició sesión y tiene 16 años o más. Cada juego tiene una clasificación ClassInd de L a 16, y la v1 no tiene compras ni anuncios.
Un SDK abierto, en npm
@uloggd/arcade-sdktiene licencia MIT y ninguna dependencia. uloggd nunca sirve el SDK a los juegos: va con el tuyo, empaquetado o como un archivo en tu propio sitio.
¿Listo para empezar?
Crea tu primera aplicación en menos de un minuto. La misma aplicación sirve para la API y, con la invitación a la vista previa, para Arcade.