API del sistema de claves
Lee y cambia la página de claves gratis de un proyecto: ajustes, pasos, embudo, visitas y cuentas bloqueadas.
La página de claves gratis de un proyecto (key.luaward.com/getkey/…) entrega claves con plazo cuando el visitante cumple los pasos que definiste. Estas rutas la leen y cambian lo que es seguro cambiar desde un programa. Cambiar exige una clave con el scope keysystem:write (Acceso total lo tiene). Para crear tú mismo una clave temporal, crea una clave normal con key_days.
Leer
GET /v3/projects/:id/key-systems
Devuelve key_systems. GET …/key-systems/:key_system_id devuelve uno con sus steps, en orden. Un sistema de claves tiene key_system_id, name, slug, page_url, project_id, script_id (el script cuyo loadstring muestra la página), enabled, key_hours, max_keys_per_visitor, allow_extending, allow_forgetting, require_discord, block_vpn, blocked_countries, session_timeout_seconds, enforce_ip_match, steps, created_at y updated_at. Un paso tiene step_id, position, title, provider, target_url, required_seconds y active. Uno que no está en este proyecto responde 404 KEY_SYSTEM_NOT_FOUND.
Cambiar ajustes
PATCH /v3/projects/:id/key-systems/:key_system_id
| Campo | Regla |
|---|---|
| name | 1 a 80 caracteres. |
| enabled, allow_extending, allow_forgetting, require_discord, block_vpn, enforce_ip_match | true o false. |
| key_hours | Cuánto dura una clave: 0,25 a 8760 horas. |
| max_keys_per_visitor | 1 a 20. |
| blocked_countries | Hasta 250 códigos de dos letras en mayúsculas, como RU. |
| session_timeout_seconds | 300 a 86400. |
| script_id | Un script activo del mismo proyecto, o null para no mostrar ninguno. |
Al menos un campo; los mismos límites del dashboard. La respuesta es el key_system actualizado. El slug hexadecimal se genera automáticamente y no se puede editar. El aspecto de la página y el proveedor y el enlace de los pasos se cambian en el dashboard.
Una regla de protección fijada aquí queda activa de verdad: require_discord, block_vpn o blocked_countries en una petición terminan la prueba que el panel hubiera iniciado para esa regla (una regla en prueba solo anota a quién detendría). A quién se lo pide require_discord (a todos, o solo a los visitantes que parecen arriesgados) lo decide el panel.
PATCH /v3/projects/:id/key-systems/:key_system_id/steps/:step_id
active, required_seconds (0 a 600, el tiempo mínimo que puede llevar el paso) y title, al menos uno. Todo lo demás del cuerpo se ignora.
Embudo, visitas y bloqueos
GET /v3/projects/:id/key-systems/:key_system_id/stats
days es 7 (por defecto) o 30. La respuesta tiene el funnel (visit, start, step, complete, claim, block), countries y blocked_because (por qué se rechazó a visitantes: vpn, country, captcha, bypass, discord, limit).
GET /v3/projects/:id/key-systems/:key_system_id/visits
Las visitas más recientes, de la más nueva a la más antigua: limit (1 a 100, por defecto 30) y before (el next_before de la página anterior, una marca de tiempo). Cada una tiene visit_id, status, step, country, browser, vpn, discord_id, started_at y finished_at. La dirección y el id del navegador de un visitante nunca forman parte.
GET /v3/projects/:id/key-systems/:key_system_id/blocks
Las cuentas y direcciones que la página rechaza: block_id, kind (discord, ip o visitor), value y reason. Una dirección o un navegador se guarda solo como hash, así que solo se muestran sus ocho primeros caracteres. POST …/blocks con discord_id (15 a 22 dígitos) y un reason opcional bloquea una cuenta de Discord (201 con block_id; 409 ALREADY_BLOCKED si ya lo está). DELETE …/blocks/:block_id quita uno (404 BLOCK_NOT_FOUND si no hay). Bloquear una dirección se hace en el dashboard.