Documentación

Guía rápida para empezar con VZ Network.

1. Inicia sesión y crea una organización

Entra con Discord en VZ Hub. Una organización agrupa tus servidores, tu equipo, tus suscripciones y tus datos.

2. Vincula un servidor de Discord

En «Mis servidores» verás los servidores donde tienes el permiso Gestionar servidor. Vincular uno lo asocia a tu organización (un servidor solo puede pertenecer a una organización).

3. Instala los bots

Cada producto es una aplicación de Discord independiente con permisos mínimos. Tras añadirlo, el bot informa a VZ Hub y la instalación pasa a ACTIVA.

4. Configura y asigna roles

Roles: Owner, Administrator, Moderator, Support Agent y Viewer, con roles adicionales por producto. Todos los permisos se verifican en el servidor.

API de VZ Vault

Crea una clave API en VZ Hub → VZ Vault → API Keys. Usa claves con solo el alcance licenses:validate dentro de aplicaciones distribuidas; las claves administrativas deben quedarse en tus servidores.

curl -X POST https://api.vznetwork.online/api/v1/licenses/validate \
  -H "Authorization: Bearer vz_live_<prefix>_<secret>" \
  -H "Content-Type: application/json" \
  -d '{"key":"VZ-XXXXX-XXXXX-XXXXX-XXXXX","fingerprint":"<device-id>"}'
const res = await fetch("https://api.vznetwork.online/api/v1/licenses/activate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VZ_VAULT_CLIENT_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({ key, fingerprint: machineId, label: hostname }),
});
const body = await res.json(); // { activationId, alreadyActive, licenseId } | { error }
  • POST /api/v1/licenses/validate · activate · deactivate
  • POST /api/v1/licenses · POST /api/v1/licenses/:id/revoke
  • GET|POST /api/v1/products
Especificación OpenAPI →