Crea tu cuenta
Regístrate en Rokuro y accede al panel de administración.
Endpoints claros para gestionar tus bots y consultar verificaciones desde tu servidor.
Regístrate en Rokuro y accede al panel de administración.
Añade tu bot de Discord con el Client ID y configura el redirect URL.
Comparte el link de verificación en tu servidor y empieza a protegerlo.
# SDK oficial de Node.js (próximamente en npm)
npm install @rokuro/sdk
# Python (próximamente en PyPI)
pip install rokurocurl -X GET https://api.rokuro.dev/api/bots
-H "Authorization: Bearer TU_API_TOKEN"
-H "Content-Type: application/json"https://api.rokuro.dev•Auth: Authorization: Bearer {token}Lista todos los bots del usuario autenticado
[
{
"id": "64f2a...",
"name": "Mi Bot",
"clientId": "123456789",
"active": true,
"verifications": 1240
}
]Crea un nuevo bot de verificación
{
"id": "64f2a...",
"name": "Mi Bot",
"secret": "rokuro_sk_live_...",
"verifyUrl": "https://rokuro.dev/verify/..."
}Estadísticas de verificación del bot
{
"total": 1240,
"today": 23,
"week": 156,
"countries": { "ES": 340, "MX": 210, "US": 180 }
}Lista verificaciones con paginación y filtros
{
"data": [...],
"total": 1240,
"page": 1,
"limit": 50
}Elimina un Discord ID de la lista negra
{ "message": "Eliminado correctamente" }verification.successSe dispara cuando un usuario completa la verificación correctamenteverification.failedSe dispara cuando falla la verificación (cuenta ya usada, ban, etc.)verification.duplicateIntento de verificación con Discord ID ya registradoblacklist.addedUn Discord ID fue añadido a la lista negrabot.activatedEl bot fue activado o reactivadobot.deactivatedEl bot fue desactivado{
"event": "verification.success",
"timestamp": "2026-04-19T10:30:00Z",
"bot_id": "64f2a...",
"data": {
"discord_id": "123456789",
"username": "Usuario#0001",
"country": "ES",
"ip_hash": "a3f8b..."
}
}
const crypto = require('crypto')
function verifySignature(payload, signature, secret) {
const hmac = crypto.createHmac('sha256', secret)
hmac.update(JSON.stringify(payload))
const digest = 'sha256=' + hmac.digest('hex')
return crypto.timingSafeEqual(
Buffer.from(digest),
Buffer.from(signature)
)
}
rokuro.pages.dev/verify/{bot_id}identify/successhttps://api.rokuro.dev/oauth/callback
Añade esta URL en tu aplicación de Discord Developer Portal → OAuth2 → Redirects
Los tokens de API son de solo lectura por defecto. Para operaciones de escritura, genera un token con permisos específicos desde el panel → Configuración → API Tokens. Los tokens no se almacenan en texto plano, solo su hash.
Limitamos a 1000 peticiones por minuto por token para peticiones normales. Los endpoints de verificación tienen límites más altos. Si superas el límite, recibirás HTTP 429 con el header Retry-After.
Todas las peticiones deben usar HTTPS. Las peticiones HTTP son rechazadas con 301 redirect. Usamos TLS 1.2+ y no aceptamos cipher suites débiles.
Verifica siempre la firma HMAC de los webhooks antes de procesarlos. Usar timingSafeEqual para comparar firmas evita ataques de timing. Ver pestaña Webhooks para el código de ejemplo.