Rokuro
Documentación

Integra Rokuro
con nuestra API

Endpoints claros para gestionar tus bots y consultar verificaciones desde tu servidor.

⌁Base URLapi.rokuro.dev
⌕AutenticaciónBearer Token
ϟRate limit1000 req/min
01⌕

Crea tu cuenta

Regístrate en Rokuro y accede al panel de administración.

02</>

Configura tu bot

Añade tu bot de Discord con el Client ID y configura el redirect URL.

03ϟ

Integra el link

Comparte el link de verificación en tu servidor y empieza a protegerlo.

›_ Instalación del SDK (próximamente)

bash
# SDK oficial de Node.js (próximamente en npm)
npm install @rokuro/sdk

# Python (próximamente en PyPI)
pip install rokuro

Tu primera petición autenticada

bash
curl -X GET https://api.rokuro.dev/api/bots
  -H "Authorization: Bearer TU_API_TOKEN"
  -H "Content-Type: application/json"
Base URL: https://api.rokuro.dev•Auth: Authorization: Bearer {token}
GET/api/botsLista todos los bots del usuario autenticado

Lista todos los bots del usuario autenticado

json
[
  {
    "id": "64f2a...",
    "name": "Mi Bot",
    "clientId": "123456789",
    "active": true,
    "verifications": 1240
  }
]
POST/api/botsCrea un nuevo bot de verificación

Crea un nuevo bot de verificación

json
{
  "id": "64f2a...",
  "name": "Mi Bot",
  "secret": "rokuro_sk_live_...",
  "verifyUrl": "https://rokuro.dev/verify/..."
}
GET/api/bots/:id/statsEstadísticas de verificación del bot

Estadísticas de verificación del bot

json
{
  "total": 1240,
  "today": 23,
  "week": 156,
  "countries": { "ES": 340, "MX": 210, "US": 180 }
}
GET/api/verificationsLista verificaciones con paginación y filtros

Lista verificaciones con paginación y filtros

json
{
  "data": [...],
  "total": 1240,
  "page": 1,
  "limit": 50
}
DELETE/api/blacklist/:discordIdElimina un Discord ID de la lista negra

Elimina un Discord ID de la lista negra

json
{ "message": "Eliminado correctamente" }

♧ Eventos disponibles

verification.successSe dispara cuando un usuario completa la verificación correctamente
verification.failedSe dispara cuando falla la verificación (cuenta ya usada, ban, etc.)
verification.duplicateIntento de verificación con Discord ID ya registrado
blacklist.addedUn Discord ID fue añadido a la lista negra
bot.activatedEl bot fue activado o reactivado
bot.deactivatedEl bot fue desactivado

Payload de ejemplo

json
{
  "event": "verification.success",
  "timestamp": "2026-04-19T10:30:00Z",
  "bot_id": "64f2a...",
  "data": {
    "discord_id": "123456789",
    "username": "Usuario#0001",
    "country": "ES",
    "ip_hash": "a3f8b..."
  }
}

♢ Verificación de firma HMAC

javascript
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)
  )
}

Flujo OAuth2 de Discord

1El usuario visita tu link de verificación: rokuro.pages.dev/verify/{bot_id}
2Rokuro redirige a Discord con tu Client ID y el scope identify
3El usuario autoriza en Discord y es redirigido de vuelta con un code
4Rokuro intercambia el code por un access token con Discord
5Obtenemos el Discord ID y username del usuario
6Guardamos la verificación y redirigimos a /success

Redirect URL a configurar en Discord

text
https://api.rokuro.dev/oauth/callback

Añade esta URL en tu aplicación de Discord Developer Portal → OAuth2 → Redirects

⌕ Tokens de API

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.

♧ Rate Limiting

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.

♙ HTTPS obligatorio

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.

›_ Webhook HMAC

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.