API e webhooks
Permissões
| Âmbito | Concede |
|---|---|
nay_car_wash.config | /nay:carwash (editor de túneis) e as definições do Car Wash no /nay. |
Conceda-o por ACE ou por uma regra, consulte Permissões.
API HTTP
Primeiro ative a API e crie um token, consulte API HTTP. As rotas respondem { "ok": true, "data": ... } e exigem Authorization: Bearer <token>.
| Método | Rota | Âmbito | Query | Dados |
|---|---|---|---|---|
| GET | /nay_car_wash/v1/history | nay_car_wash.history.read | identifier, kind (tunnel ou manual), limit (1 a 100, predefinição 20), before (id) | items (id, identifier, kind, location, program, price, time), do mais recente para o mais antigo, e next: passe-o como before para obter a página seguinte. |
| GET | /nay_car_wash/v1/stats | nay_car_wash.stats.read | days (1 a 31, predefinição 7), utcOffset (minutos, -720 a 840, predefinição: o relógio do servidor) | utcOffset usado, total, byDay (todos os dias listados) e byLocation, cada um com washes e revenue. |
| GET | /nay_car_wash/v1/tunnels | nay_car_wash.tunnels.read | index, label, enabled, entry de cada túnel. |
Exemplo:
bash
curl -H "Authorization: Bearer nay_1_xxxxxxxx" "https://api.example.com/nay_car_wash/v1/stats?days=7"Eventos de webhook
Escolha-os no separador Webhooks do /nay, consulte Webhooks.
| Evento | Quando | Dados |
|---|---|---|
nay_car_wash.wash | Uma lavagem no túnel é concluída. | player (nome), identifier, tunnel, program, price |
nay_car_wash.manual | Uma sessão numa máquina de alta pressão termina. | player (nome), identifier, station, price |
Com um webhook do Discord, cada lavagem torna-se um embed no seu canal, no idioma do servidor.