Conceptos
Lo mínimo que necesita saber para integrar Rimasun sin sorpresas.
Cuenta y plan
Su cuenta es su empresa en Rimasun. Tiene un plan (Gratis, PRO o Personalizado) que fija cuánto puede usar en total, sumando todos sus proyectos. Los minutos se cuentan por minuto-participante: una llamada de 10 minutos entre 2 personas son 20 minutos.
Proyecto
Un proyecto agrupa salas, llaves, calidad, límites y webhooks de una misma aplicación (p. ej. «Clínica — producción» y «Clínica — pruebas»). Cada proyecto tiene su propio uso y su auditoría. Puede fijar límites más bajos que los del plan (p. ej. duración máxima de 30 minutos), pero nunca más altos.
Llave
Una llave autentica a su servidor ante la API. Tiene dos partes:
| Parte | Ejemplo | Dónde va |
|---|---|---|
| Llave | rk_8fQ2… | Su servidor (no es secreta por sí sola, pero no la publique) |
| Secreto | rs_Zt91… | Solo en las variables de entorno de su servidor. Se muestra una vez. |
Puede tener varias llaves por proyecto, restringirlas a ciertas IP, darles vencimiento, rotarlas y revocarlas desde Mi cuenta.
Sala
Una sala es el lugar de la llamada: todos los que tienen un token de la misma sala se ven y se escuchan.
El nombre lo elige usted (1–64 caracteres A-Z a-z 0-9 . _ -), por ejemplo cita-250.
Si no existe, Rimasun la crea al emitir el primer token, con los límites del proyecto. Las salas vacías se cierran solas.
Identidad
La identidad distingue a cada persona dentro de una sala (p. ej. medico-41, paciente-174).
Debe ser única por persona: si la misma identidad entra desde otro dispositivo, la conexión anterior se cierra
(«Se unió desde otro dispositivo»). El nombre es lo que se muestra.
Roles
| Rol | Publica audio/video | Administra la sala | Uso típico |
|---|---|---|---|
anfitrion | Sí | Sí | Médico, docente, anfitrión |
participante | Sí | No | Paciente, alumno, invitado |
oyente | No (solo ve y escucha) | No | Público de una charla |
Token
El token es la entrada de una persona a una sala. Lo emite Rimasun a pedido de su servidor (POST /v1/tokens),
vale solo para esa sala e identidad, y vence en ttl_min minutos (como máximo lo que permita el proyecto).
Su servidor decide a quién se lo da: Rimasun no sabe quiénes son sus usuarios.
Calidad
La calidad se configura por proyecto y llega dentro de la credencial; el SDK la aplica sola.
| Perfil | Resolución | Uso |
|---|---|---|
audio | — | Solo voz (también se fuerza si su plan es solo de voz) |
360p | 640×360 | Redes móviles débiles |
720p | 1280×720 | Consulta estándar (por defecto) |
1080p | 1920×1080 | Detalle alto (PRO y Personalizado) |
Además: fps, tope de bitrate, códec (vp8, h264, vp9, av1), simulcast, calidad adaptativa y si se permite compartir pantalla.
Si su plan tiene un perfil máximo menor, se usa el menor.
Límites por plan
Valores iniciales (pueden cambiar; los vigentes se ven en Planes y en Mi cuenta):
| Gratis | PRO | Personalizado | |
|---|---|---|---|
| Precio | 0 · 30 días | 49 USD / 185 PEN al mes | Calculado según lo que arme |
| Minutos al mes | 1 000 | 10 000 | 1 000 – 200 000 |
| Calidad máxima | 720p | 1080p | 1080p |
| Salas simultáneas | 2 | 50 | A elección |
| Participantes por sala | 4 | 10 | 2 – 50 |
| Duración máxima de una sala | 60 min | 240 min | 240 min |
| Proyectos / llaves | 1 / 2 | 5 / 20 | 10 / 50 |
| Compartir pantalla | No | Sí | Sí |
Al llegar al 80 % y al 100 % de los minutos recibe un correo. Con el límite alcanzado, la API responde
403 limite_minutos; con el plan vencido, 403 plan_vencido. Ver Errores y límites.
Eventos
Rimasun puede avisar a su servidor cuando una sala empieza o termina y cuando alguien entra o sale. Ver Webhooks.
Rimasun · documentación en español · cambios por versión