Blixye API

Inicia el flujo OAuth de Roblox. Tras autorizar, el navegador vuelve a http://127.0.0.1:<loopback_port>/blixye-oauth?code=… y la app remata con check_oauth_status + finish.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "url": "https://authorize.roblox.com/?...",
  "session_token": "abc123..."
}

Inicia el flujo OAuth de Discord. Requiere apikey. Scope: identify guilds.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "url": "https://discord.com/oauth2/authorize?...",
  "session_token": "abc123..."
}

Remata el flujo OAuth. Sin finish devuelve siempre pending: la cuenta solo se entrega (y Discord solo se vincula) con el codigo que llego a la app por 127.0.0.1.

Parametros

Respuesta pendiente

{ "ok": true, "status": "pending" }

Respuesta completa (Roblox)

{
  "ok": true,
  "status": "complete",
  "roblox_id": "727083479",
  "roblox_username": "bielarano",
  "apikey": "sk_...",
  "user_id": 1
}

Respuesta completa (Discord)

{
  "ok": true,
  "status": "complete",
  "result": "success|already_linked|limit_reached",
  "discord_id": "123456789012345678",
  "discord_username": "user#1234",
  "admin_guilds": [
    { "id": "999...", "name": "Mi Server", "icon": "hash..." }
  ]
}

Callback de Roblox (automatico). Devuelve HTML. No llamar manualmente.

Callback de Discord (automatico). Devuelve HTML. No llamar manualmente.

Obtiene perfil completo del usuario: Roblox, Discord accounts, servidores.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "user_id": 1,
  "roblox_id": "727083479",
  "roblox_username": "bielarano",
  "discord_accounts": [
    { "discord_id": "123...", "discord_username": "user#1234" }
  ],
  "servers": [
    {
      "server_id": 8,
      "server_name": "Mi Server",
      "server_type": "voice",
      "logo_url": null,
      "role": "owner"
    }
  ]
}

Devuelve solo las cuentas de Discord vinculadas.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "user_id": 1,
  "discord_accounts": [
    { "discord_id": "123...", "discord_username": "user#1234" }
  ]
}

Devuelve texto plano "si" o "no".

Las versiones en vigor, las que ha aceptado la cuenta y si le falta alguna. accepted es, por documento, la version en vigor si la ha aceptado y si no la ultima que acepto (null si ninguna). pending es true si le falta aceptar la version en vigor de cualquiera de los dos.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "current":  { "terms": "2026-09-26", "privacy": "2026-09-26" },
  "accepted": { "terms": null, "privacy": "2026-09-04" },
  "pending": true
}

Errores

400 sin apikey o con formato invalido · 401 apikey que no existe o ha caducado.

Acepta las versiones LEIDAS de los dos documentos. Tienen que ser las dos en vigor: si alguna no lo es (cambio mientras se leia) o falta, 409 con las de ahora y no se apunta nada. Idempotente: aceptar otra vez lo mismo no escribe nada ni mueve la hora de la primera vez. Guarda la IP y el dispositivo (device si viene; si no, el de la sesion). Devuelve lo mismo que legal_status.

Parametros

Respuesta OK (200)

{
  "ok": true,
  "current":  { "terms": "2026-09-26", "privacy": "2026-09-26" },
  "accepted": { "terms": "2026-09-26", "privacy": "2026-09-26" },
  "pending": false
}

Error 409 (version que ya no rige)

{
  "ok": false,
  "error_code": "stale_legal_version",
  "error": "The Terms of Service or the Privacy Policy changed while you were reading them. Read them again.",
  "current":  { "terms": "2026-09-26", "privacy": "2026-09-26" },
  "accepted": { "terms": null, "privacy": "2026-09-04" },
  "pending": true
}

Otros errores

400 / 401 como en legal_status · 503 si falta la migracion de legal_acceptances (mientras tanto legal_status contesta pending: false, para no pedir lo que no se puede apuntar).

El texto de los documentos legales de un idioma, TAL CUAL lo publica la web (https://blixye.com/assets/blixye/legal.json, blixye.legal_source_url), con diez minutos de cache y la ultima copia buena de respaldo. Sin llave: se lee antes de entrar. De ahi salen tambien las versiones que piden legal_status y accept_legal (la configuracion solo es el respaldo).

Parametros

Respuesta OK (200)

{
  "ok": true,
  "idioma": "es",
  "versiones": { "terms": "2026-09-26", "privacy": "2026-09-26", "cookies": "2026-09-05", "...": "..." },
  "documentos": [ { "id": "terms", "titulo": "Términos del Servicio", "version": "2026-09-26", "secciones": [ "..." ] } ]
}

Errores

503 si la web no contesta y no hay copia guardada: el cliente enseña entonces la que lleva dentro.

Crea un servidor nuevo. El creador se convierte en owner.

Respuesta OK (201)

{
  "ok": true,
  "server": {
    "id": 8,
    "server_name": "Mi Server",
    "join_code": "ABCD1234",
    "is_public": true,
    "max_members": 50,
    "owner_user_id": 1,
    ...
  }
}

Obtiene informacion de un servidor (incluye config, roles, economy).

Lista todos los servidores del usuario autenticado.

Busca servidores publicos. Paginado.

Actualiza datos del servidor. Campos opcionales, solo se actualizan los enviados.

Elimina el servidor y todos sus datos.

Unirse a un servidor por codigo.

Respuesta

{ "ok": true, "joined": true, "server_id": 8, "server_name": "Mi Server" }
// ya miembro:
{ "ok": true, "joined": false, "reason": "already_member", "server_id": 8 }

Abandonar servidor. El owner no puede salir.

Regenera o establece un codigo de union personalizado.

Lista miembros del servidor, paginado.

Cambia el rol de un miembro. No puedes asignar un rol >= al tuyo.

Expulsa a un miembro. Opcional: elimina sus personajes.

Vincula un servidor Blixye a un guild de Discord.

Error 409 si el guild ya esta vinculado a otro servidor.

Desvincula el guild de Discord del servidor.

Obtiene configuracion del servidor (moneda, items cash, app_names, etc).

Actualiza config del servidor. Todos opcionales.

Calcula max personajes para un usuario segun sus roles de Discord.

Configuracion del DNI: nombre documento, edad min/max, formato numero, campos, nacionalidades.

Crea un personaje con DNI. Valida limites de personajes, edad, nacionalidad, etc.

Campos actualizables: name, surname, nationality, gender, birthdate, birth_time, image_url, custom_data.

Busca personajes por nombre, apellido o DNI number. Max 50 resultados.

Lista items. Filtrable por category_id y search.

Items visibles en la tienda (shop_visible=true, con precio).

Update parcial. Mismos campos que create + item_id.

Inventario de un personaje. Miembros solo ven el propio.

Mismos params que give.

Transferir item entre personajes. Item debe tener can_gift=true.

Eliminar item propio. Item debe tener can_delete=true.

Otorga licencia a un personaje. Si estaba revocada, la reactiva con max_points.

Revoca licencia. Guarda revoked_by="user#{user_id}".

Resta puntos. Si llega a 0, auto-revoca con revoked_by='auto:points_depleted'.

Respuesta

{ "ok": true, "points_remaining": 3, "is_revoked": false }

Lista licencias de un personaje (con estado de revocacion y puntos).

Respuesta

{ "ok": true, "total_cost": 500, "payment_method": "wallet" }

Metodos de pago:

• wallet: paga con billetes del wallet (algoritmo greedy, denominacion alta primero)
• bank: debita de cuenta bancaria (v2 primero, fallback legacy)
• auto: intenta wallet, si no alcanza, intenta bank

Compra una licencia de la tienda. Misma logica de pago.

Crea cuenta bancaria legacy + tarjeta para un personaje.

Respuesta

{ "ok": true, "account_id": 1, "card_number": "1234567890123456", "cvv": "123", "balance": 0 }

Info bancaria de un personaje (card_number, balance, has_pin, cvv si es propio).

Billetes en el wallet con total_cash calculado.

Balance total: bank + wallet.

{ "ok": true, "bank_balance": 1000, "wallet_total": 250, "total": 1250, "has_bank": true }

Transferencia entre cuentas (por card_number+cvv o character_id).

Retira dinero del banco al wallet (billetes).

Deposita billetes del wallet al banco.

Historial de transacciones. Paginado.

Lista cuentas donde el personaje es miembro.

Dashboard completo: cuentas, total_balance, tarjetas activas, deudas, prestamos, credit score.

Solo el dueno. Balance debe ser 0. No puedes cerrar la cuenta personal ni la principal.

Transferencia entre tus propias cuentas.

Respuesta incluye cvv (solo se muestra en creacion).

Crea tarjeta compartida con otro personaje. Auto-agrega como miembro de cuenta.

Establece o cambia PIN. Si ya tiene PIN, old_pin es requerido.

Reset forzado del PIN (admin).

Verifica PIN. Se bloquea tras N intentos fallidos.

Respuesta OK

{ "ok": true, "has_pin": true, "verified": true }

Error 401 (incorrecto)

{ "ok": false, "error": "PIN incorrecto", "attempts_remaining": 2 }

Error 423 (bloqueado)

{ "ok": false, "error": "PIN bloqueado", "remaining_minutes": 15 }

Respuesta

{
  "ok": true,
  "credit": {
    "score": 750,
    "tier": "excellent",
    "factors": {...},
    "min_score": 0,
    "max_score": 1000,
    "tiers": { "excellent": 800, "good": 650, "fair": 500, "poor": 0 }
  }
}

Puede auto-aprobarse segun config. Interes basado en credit score.

Requiere permiso manage_vehicle_models.

Requiere permiso manage_vehicle_config.

Ordenados por hierarchy DESC.

Requiere permiso manage_roles. Tu hierarchy debe ser > al del nuevo rol.

Requiere manage_roles y/o manage_role_permissions. Roles de sistema: solo se puede cambiar el color.

No se pueden borrar roles de sistema. Miembros se reasignan a "Member".

Transfiere ownership a otro miembro. El owner actual baja a Admin.

Inicia sesion de cacheo. Devuelve items searchable del target.

Decide item por item: confiscated o left.

Completa cacheo. Todos los items deben estar confirmados. Los confiscated se eliminan del inventario.

Cancela sin aplicar confiscaciones.