Para qué sirve
La API permite que un código haga lo que tú haces en el editor: listar tus proyectos, leer y escribir sus archivos, y ejecutar un circuito para ver si se comporta como debe. La gente la usa para probar un sketch en cada push con una GitHub Action, para mantener el código en su propio editor mientras el circuito corre en Mokxi, y para automatizar las partes aburridas.
Everything is on the página de desarrolladores: una guía rápida, los límites de cada plan, los códigos de error y todas las rutas.
Crear un token
Abre Configuración al pie de la barra lateral del editor y elige Tokens de API. Dale al token un nombre que reconozcas después, marca los permisos que necesita y elige cuándo expira.
- projects:read lee tus proyectos y sus archivos.
- projects:write los crea, modifica y elimina.
- simulate ejecuta circuitos.
El token se muestra una sola vez, justo después de crearlo. Cópialo en ese momento: Mokxi guarda solo una copia codificada y no puede mostrarlo de nuevo. Si lo pierdes, revócalo y crea otro.
Iniciar sesión desde una herramienta
The Mokxi CLI and editor plugins do not need a pasted token. They show you a short code and open mokxi.com/device. Revisa el nombre de la herramienta y lo que pide, y apruébala. Recibe un token propio, que aparece en tu lista como cualquier otro.
Aprueba solo un código que hayas iniciado tú mismo, justo ahora.
Revocar
Cada token aparece en Desarrollador con cuándo se usó por última vez y cuánto hizo este mes. Revocar lo detiene de inmediato, esté donde esté.
Límites
Cada plan tiene sus propios límites de peticiones por minuto, simulaciones por hora y cuánto puede durar una simulación:
| Gratis | Pro y todos los demás planes de pago | |
|---|---|---|
| Peticiones por minuto, por token | 60 | 600 |
| Simulaciones por hora, por token | 30 | 600 |
| Tiempo simulado en una ejecución | 10 segundos | 60 segundos |
| Tokens en vivo por cuenta | 5 | 25 |
La tabla completa está en la página para desarrolladores.
Minutos de simulación cada mes
Las simulaciones también cuentan para una asignación mensual de tiempo simulado, sumada entre todos tus tokens:
- Gratis: 100 minutos al mes.
- Pro y Estudiante: 2,000 minutos al mes.
- Ultra (ya no se vende; las cuentas que lo tienen lo conservan): 5,000 minutos al mes.
- Salón de clases (y el plan Docente retirado): 2,000 minutos al mes, compartidos por la clase. Las ejecuciones del maestro y las de los estudiantes en las clases pagadas del maestro cuentan todas para el mismo total.
- Escuelas y universidades: podemos asignarte una cantidad mayor. Escríbenos a mokxi.com/schools/quote.
El contador se reinicia a la medianoche UTC del primero de cada mes. Una simulación que empieza antes de llegar al límite siempre termina. Cuando se alcanza el límite, las nuevas simulaciones se rechazan hasta el primero del mes siguiente, con un mensaje que lo indica. Nunca se te cobra por excederte.
Developer en Configuración muestra cuántos minutos has usado este mes, cuándo se reinicia el contador y si el total se comparte con tu clase.