← Inicio
⌕
Pregunta en el Discord
General ER:LC FiveM API
Desarrolladores
DOCUMENTACIÓN/API pública v1

Llaves y ámbitos

Las llaves de la API pública: quién las crea, qué ámbitos hay, qué abre cada uno, cómo se rotan y cuántas da cada plan.

A día de hoy la app todavía no tiene la pantalla para crear llaves de la API ni webhooks. Esta página describe cómo funcionan las llaves.
OJO A día de hoy la app todavía no tiene la pantalla para crear llaves de la API ni webhooks. Esta página describe cómo funcionan las llaves.
Una llave es de un servidor. Las crea el dueño del servidor o un rol con el permiso manage_api_keys («Crear, rotar y revocar las llaves de la API pública y los webhooks del servidor»). Ese permiso no viene con el rol de administrador: hay que darlo aparte, porque una llave puede leer el servidor entero.
OJO Una llave es de un servidor. Las crea el dueño del servidor o un rol con el permiso manage_api_keys («Crear, rotar y revocar las llaves de la API pública y los webhooks del servidor»). Ese permiso no viene con el rol de administrador: hay que darlo aparte, porque una llave puede leer el servidor entero.
OJO
Forma: bx_live_ seguido de 48 letras y números. Se enseña una sola vez; Blixye solo guarda su huella (SHA-256).
Ámbitos: al menos uno, de la lista de abajo. No hay comodín.
IP permitidas: opcional, hasta 20 IP o rangos CIDR (IPv4 o IPv6). Vacío = desde cualquiera. Desde otra IP, 403 ip_not_allowed.
Caducidad: opcional, de 1 a 3650 días. Caducada, 401 api_key_expired.
Los 16 ámbitos
OJO Los 16 ámbitos
OJO
server:read abre GET /server.
characters:read abre GET /characters, /characters/{id} y /characters/{id}/licenses.
inventory:read abre GET /characters/{id}/inventory, junto con characters:read.
vehicles:read abre GET /vehicles.
records:read abre GET /citations, /arrests y /records; records:write, POST /citations.
dispatch:read abre GET /calls y /calls/{id}; dispatch:write, POST /calls y PATCH /calls/{id}.
units:read abre GET /units.
corporations:read abre GET /corporations, /corporations/{id}/ranks y /corporations/{id}/members.
bank:read abre GET /bank/transactions.
members:read abre GET /members y /roles.
moderation:read abre GET /sanctions y /bans; moderation:write, POST /sanctions.
erlc:read abre GET /erlc/sessions.
webhooks:manage abre todo /webhooks. Solo deja suscribir un webhook a los eventos de los ámbitos que tenga la misma llave (Webhooks).
Los ámbitos de lectura dan también los eventos de su recurso en GET /v1/events y en los webhooks (dispatch:read, units:read, records:read, characters:read, vehicles:read, moderation:read, erlc:read y corporations:read; la lista está en API v1: eventos). Una ruta sin su ámbito contesta 403 missing_scope, con los que faltan en details.required_scopes.
OJO Los ámbitos de lectura dan también los eventos de su recurso en GET /v1/events y en los webhooks (dispatch:read, units:read, records:read, characters:read, vehicles:read, moderation:read, erlc:read y corporations:read; la lista está en API v1: eventos). Una ruta sin su ámbito contesta 403 missing_scope, con los que faltan en details.required_scopes.
Rotar y revocar
OJO Rotar y revocar
OJO
Rotar crea una llave nueva con los mismos ámbitos, IP y caducidad. La vieja deja de valer al momento o, si das un margen de hasta 1440 minutos (24 horas), al acabar ese margen, para cambiarla en tu integración sin cortar. Rotar no cuenta contra el tope del plan.
Revocar es inmediato: la siguiente petición con esa llave contesta 401 api_key_revoked.
Una llave mandada en la URL o en el cuerpo se rechaza con 400 api_key_in_query y hay que rotarla: esas llaves acaban en los registros de los servidores web.
30 fallos de autenticación en un minuto desde una misma IP dan 429 a esa IP, sin mirar la llave.
Cuántas da cada plan
OJO Cuántas da cada plan
api_keys son las llaves activas del servidor; api_rpm, las peticiones por minuto de CADA llave; webhook_endpoints, los destinos de webhook del servidor. Pasar del tope de llaves o de destinos da 409 limit_reached.
OJO api_keys son las llaves activas del servidor; api_rpm, las peticiones por minuto de CADA llave; webhook_endpoints, los destinos de webhook del servidor. Pasar del tope de llaves o de destinos da 409 limit_reached.
OJO
plan api_keys api_rpm webhook_endpoints
none 0 0 0
plus 1 60 1
premium 3 300 5
business 10 1200 20
← Anterior
API pública v1: introducción
Siguiente →
Errores
32 / 54 Falta algo aquí →
PASO 1 · PLAN ×
Elige el plan de tu servidor
Después del pago le pones nombre y lo configuramos juntos. Puedes cambiar de plan cuando quieras.
FREE1 DE 1 LIBRE El CAD completo y el bot. Para probarlo. 0 €
PLUSAL MES CAD completo, moderación, actividad y economía. 5,99 €
PREMIUMER:LC Y FIVEM Todo lo de PLUS, con mapa en vivo y límites más altos. 12,99 €
ENTERPRISEPERMANENTE Todo PREMIUM para siempre, hospedado por ti y sin cuotas nunca. Consultar
Continuar al pago
Cancelas cuando quieras · 14 días de desistimiento, salvo que pidas empezar al momento
Confirmar y pagar
ER:LC PREMIUM
Mensual · una licencia
12,99 €
CORREO
TARJETA
Atrás
En desarrollo — no disponible
Blixye está en desarrollo: todavía no se pueden contratar servicios.Pago seguro · IVA incluido
Ponle nombre a tu servidor
Es el nombre que verán tus jugadores en el launcher y en Discovery. Lo puedes cambiar cuando quieras.
NOMBRE DEL SERVIDOR
Le daremos un código corto, tipo SKY-T2Q, para vincular el launcher.
SIGUIENTE Al crearlo abrimos la guía de configuración: launcher, Discord y módulos en tres pasos.
Atrás
Crear el servidor
Escribe al menos 3 letras.
PASO 1 DE 3 · GUÍA ×
1. Pásale el launcher a tu gente
Es lo único que instalan, y solo una vez. Entran con Discord, verificamos su cuenta de Roblox y el overlay aparece sobre la partida.
Ir a la descarga
2. Crea tus departamentos
Policía, sheriff, bomberos o lo que uses. Cada uno con sus rangos y permisos: eso decide quién puede sancionar, fichar o ver expedientes.
3. Abre el servidor
Con el primer turno de servicio empiezan a llenarse las llamadas, la actividad y la economía. A partir de ahí solo ajustas.
Atrás
Siguiente
⌕ ESC
Overlay in-game Radio, ficha y despacho encima de la partida, sin alt-tab. ER:LC CAD y departamentos Llamadas en cola, unidades con estado y rosters con rangos. ER:LC Moderación y apelaciones Sanciones con contexto, logs y apelaciones que no se pierden. ER:LC Actividad del staff Cuotas por rango, turnos y un informe semanal automático. ER:LC Economía y negocios Cuentas, nóminas, negocios de jugadores e inventario. ER:LC Blixye Framework El núcleo: personajes, permisos, base de datos y bridge QBCore y ESX. FiveM Inventario Peso, contenedores e intercambios seguros entre jugadores. FiveM MDT policial Fichas, multas, órdenes de busca y consultas de matrícula. FiveM Banca Cuentas, transferencias, nóminas y cuentas de empresa. FiveM Trabajos Turnos, nóminas y jerarquía por empresa. FiveM Garajes Propiedad de vehículos, daños persistentes y depósito. FiveM Casas Compra, alquiler, muebles y almacenamiento propio. FiveM Teléfono Mensajes, llamadas, apps y redes sociales del rol. FiveM Médico Heridas por zona, tratamientos y hospital con camas. FiveM Todos los scripts Los ocho scripts sin límite, en un pago permanente o por suscripción. FiveM Instalar Blixye en ER:LC Del servidor vacío al primer turno de servicio, sin tocar un archivo del juego. Documentación Instalar el framework de FiveM El zip, el SQL y el bridge de tu base actual, en el orden correcto. Documentación Tu primera semana Qué configurar cada día para no acabar con veinte cosas a medias. Documentación CAD y despacho Llamadas, unidades y prioridades dentro del overlay. Documentación Moderación y apelaciones Sanciones con pruebas, apelaciones y el registro que te cubre. Documentación Actividad y turnos Horas, cuotas y quién está patrullando de verdad. Documentación Scripts y versión gratis Qué limita la versión gratis de cada script y qué abre la completa. Documentación Bridge con QBCore y ESX Convivir con tu base actual sin duplicar jugadores ni dinero. Documentación Rendimiento Dónde mirar cuando el servidor va a tirones. Documentación
Nada con ese nombre. Prueba con «inventario», «CAD» o «licencias».
↵ abrir CTRL K buscar 37 resultados
ROTAR LA KEY ×
! La key actual deja de valer en el momento en que confirmes. Esto no se puede deshacer.
key actual → key nueva al confirmar
Pega la key nueva en el config del script.
Reinicia el recurso: refresh y ensure.
Mientras no lo hagas, el script no cargará.
Sí, rotar la key Cancelar
Qué incluye cada plan ×
FREE
DISCORD
PLUS
PREMIUM
ENTERPRISE
Precio
Gratis
2,99 €/mes
5,99 €/mes
12,99 €/mes
Consultar
GENERAL
Miembros del servidor
50
—
150
∞
∞
Código de invitación propio
—
✓
✓
✓
✓
CAD
Corporaciones máx.
2
—
6
∞
∞
Subdivisiones máx.
0
—
6
∞
∞
Borrado de datos MDT
1 mes
—
1 año
Nunca
Nunca
Acceso al MDT
Completo
—
Completo
Completo
Completo
Historial de logs
7 días
—
90 días
∞
∞
Exportar a PDF
—
—
—
✓
✓
Investigaciones
—
—
✓
✓
✓
Almacenamiento de pruebas
—
—
Sin límite
Sin límite
Sin límite
Leyes propias
50
—
150
∞
∞
Formularios del MDT
3
—
15
∞
∞
Mapa y ubicación en tiempo real
—
—
—
✓
✓
Bodycam
—
—
✓
✓
✓
Búsqueda avanzada
—
—
✓
✓
✓
Canales de radio (Discord VC)
10
—
50
100
∞
Roles por corporación
15
—
50
∞
∞
BANK
Cuentas bancarias
1 por pj
—
3 por pj
6 por pj
12 por pj
Transferencias
✓
—
✓
✓
✓
Historial de movimientos
✓
—
✓
✓
✓
Tarjetas por cuenta
1
—
2
3
5
Tarjetas temporales
Duración fija
—
✓
✓
✓
Tarjetas por usos
—
—
Máx. 5 por pj
✓
✓
Recompensas por rol
✓
—
✓
✓
✓
Permitir saldo negativo
—
—
✓
✓
✓
Transferencias programadas
—
—
✓
✓
✓
Deudas entre jugadores
—
—
✓
✓
✓
Límites por operación
—
—
✓
✓
✓
Cuentas compartidas
Máx. 2 miembros
—
Máx. 5 miembros
∞
∞
ADMIN
Mapa de calor de jugadores
—
—
—
✓
✓
Formularios del bot
3
5
10
∞
∞
Tu servidor en el teléfono
—
—
✓
✓
✓
Roles de admin máx.
owner +2
owner +5
owner +10
∞
∞
Soporte prioritario
—
✓
✓
✓
✓
Historial de auditoría de staff
7 días
30 días
90 días
∞
∞
Funciones beta
—
✓
✓
✓
✓
Crear servidor
Los addons de personajes y almacenamiento se añaden sobre cualquier plan.
Cookies SOLO ESENCIALES
Solo usamos las imprescindibles: tu sesión, la seguridad al entrar y tu idioma. No hay analítica ni publicidad, así que no hay nada que aceptar ni rechazar.
Entendido
Política de cookies