API y webhooks
Permisos
| Scope | Concede |
|---|---|
nay_car_wash.config | /nay:carwash (editor de túneles) y los ajustes de Car Wash en /nay. |
Concédelo con ACE o con una regla, consulta Permisos.
API HTTP
Primero activa la API y crea un token, consulta API HTTP. Las rutas responden { "ok": true, "data": ... } y necesitan Authorization: Bearer <token>.
| Método | Ruta | Scope | Query | Datos |
|---|---|---|---|---|
| GET | /nay_car_wash/v1/history | nay_car_wash.history.read | identifier, kind (tunnel o manual), limit (de 1 a 100, 20 por defecto), before (id) | items (id, identifier, kind, location, program, price, time), los más recientes primero, y next: pásalo como before para la página siguiente. |
| GET | /nay_car_wash/v1/stats | nay_car_wash.stats.read | days (de 1 a 31, 7 por defecto), utcOffset (minutos, de -720 a 840, por defecto: el reloj del servidor) | utcOffset usado, total, byDay (todos los días listados) y byLocation, cada uno con washes y revenue. |
| GET | /nay_car_wash/v1/tunnels | nay_car_wash.tunnels.read | index, label, enabled, entry de cada túnel. |
Ejemplo:
bash
curl -H "Authorization: Bearer nay_1_xxxxxxxx" "https://api.example.com/nay_car_wash/v1/stats?days=7"Eventos de webhook
Elígelos en la pestaña Webhooks de /nay, consulta Webhooks.
| Evento | Cuándo | Datos |
|---|---|---|
nay_car_wash.wash | Termina un lavado en túnel. | player (nombre), identifier, tunnel, program, price |
nay_car_wash.manual | Termina una sesión de hidrolimpiadora. | player (nombre), identifier, station, price |
Con un webhook de Discord, cada lavado se convierte en un embed en tu canal, en el idioma del servidor.