El editor

Internet real

Permite que una placa con WiFi acceda a servicios web reales, webhooks y brokers MQTT públicos. Gratis al iniciar sesión, con más en Pro, y desactivado hasta que lo actives.

Encenderlo

Funciona en toda placa con WiFi simulado, entre ellas las placas ESP32 y ESP8266, la Pico W y la Uno R4 WiFi (ver WiFi, simulado).

Abre el panel Cloud y marca Internet real. Mokxi revisa primero tu cuenta:

  • Sin sesión iniciada, el interruptor te dice que inicies sesión gratis, y tu placa conserva la red simulada.
  • En Gratis, con sesión iniciada y tu correo confirmado, se enciende con la asignación de Gratis (abajo).
  • En Pro, el precio de estudiante, Salón de clases y la prueba gratis de Pro, se enciende con la asignación mayor.

Cada sesión inicia con el interruptor apagado, así un proyecto nunca llega al internet solo con abrirse. La única excepción es una placa en el punto de acceso Wokwi-GUEST, que es lo que usa un proyecto importado de Wokwi: como en Wokwi, ese punto de acceso llega al internet, así que el interruptor se enciende solo cuando el proyecto corre. Desmárcalo y queda apagado hasta que recargues.

Mientras esté encendido:

  • una petición a un nombre fuera de .mokxi sale por la pasarela de Mokxi, y la respuesta regresa a tu sketch, https:// incluido (la pasarela hace el TLS, así que usa http.begin("https://..."));
  • time.mokxi, weather.mokxi, echo.mokxi, api.mokxi y la dirección propia de la placa siguen simuladas;
  • cada petición sigue apareciendo en el registro del panel Cloud, con una nota que dice que pasó por la pasarela.
#include <WiFi.h>
#include <HTTPClient.h>

HTTPClient http;
http.begin("https://api.open-meteo.com/v1/forecast?latitude=52.5&longitude=13.4&current=temperature_2m");
int code = http.GET();
Serial.println(code);
Serial.println(http.getString());
http.end();

Un webhook es un POST de la misma forma: http.addHeader("Content-Type", "application/json") y http.POST("{\"temp\":21.5}").

MQTT

Un sketch publica un mensaje de MQTT con un solo HTTP POST a mqtt.mokxi:

http.begin("http://mqtt.mokxi/publish?broker=test.mosquitto.org&topic=mokxi/demo/temp");
http.addHeader("Content-Type", "text/plain");
int code = http.POST("21.5");   // 200 when the broker took it

La pasarela lo envía al broker como MQTT sobre WebSockets. Los brokers son los brokers públicos de prueba test.mosquitto.org (el predeterminado), broker.hivemq.com y broker.emqx.io. Observa el tema desde cualquier cliente MQTT para verlo llegar.

Lo que no hace, con honestidad: PubSubClient y otras bibliotecas que abren una conexión TCP directa al puerto 1883 no funcionan, porque la placa simulada no tiene un socket TCP y nuestra pasarela tampoco puede abrir uno. Publicar es en un solo sentido: la pasarela no se suscribe ni trae mensajes de vuelta a la placa. Los temas con + o # se rechazan.

Telegram

UniversalTelegramBot.h está integrado, y un bot de Telegram funciona con el interruptor encendido: cada una de sus llamadas es una petición HTTPS a api.telegram.org, que la pasarela envía. Consigue un token con BotFather, ponlo en el sketch, marca Internet real y ejecútalo; el EchoBot de la biblioteca está en el explorador de bibliotecas.

  • El cliente no se usa. El WiFiClientSecure que le das al bot, y el TELEGRAM_CERTIFICATE_ROOT que le das, aquí no transmiten nada: la pasarela hace el TLS y revisa el certificado de Telegram.
  • Con el interruptor apagado, cada llamada devuelve false o 0 de inmediato, y el monitor serie dice una vez que Telegram necesita el internet real.
  • Cuida los límites de abajo. Pedir mensajes cada segundo son 60 peticiones por minuto, más de lo que permite cualquier plan, así que consulta más o menos cada diez segundos. En Gratis, las 50 diarias de un proyecto duran unos minutos de eso: suficiente para verlo responder, no para dejarlo corriendo.
  • Las fotos y archivos enviados como bytes no se transmiten, porque la pasarela acepta texto. sendPhoto() con la URL de una imagen sí funciona.

Tiempo

configTime() funciona y getLocalTime() responde, y también el getFormattedTime() de NTPClient, pero el reloj es el de la simulación misma, que inicia en 2026-01-01 00:00:00 UTC: no es la hora real. NTP es un protocolo UDP, el internet real transmite HTTP, y la simulación no sabe la fecha de hoy. Para la hora real del día, pregunta a una API de tiempo por HTTP con el interruptor encendido.

Los límites

Gratis Pro
Peticiones al día, por cuenta 100 1,000
Peticiones al día, por proyecto 50 500
Peticiones por minuto, por cuenta 10 30
Peticiones por minuto, por proyecto 10 20
Cuerpo de la petición 1,024 bytes 2,048 bytes
Respuesta conservada 2,048 bytes 4,096 bytes
mensaje MQTT 512 bytes 1,024 bytes

Los días son UTC. En Gratis, una red también comparte 300 solicitudes al día y 20 por minuto entre todas las cuentas con sesión iniciada en ella.

  • Al pasar un límite la placa recibe el estado 429 con una frase que indica qué límite alcanzó. Pon un delay() en tu loop: una lectura cada diez segundos durante un cuarto de hora son noventa solicitudes.
  • Tamaños: una respuesta más larga se corta, y el registro lo indica. Un cuerpo que no sea texto (una imagen, por ejemplo) se omite.
  • Tiempo: el host tiene 4 segundos para responder.
  • Métodos: GET y POST, en los puertos 80, 443, 8080 y 8443.
  • No se siguen redirecciones. Un 301 o 302 llega a tu sketch tal cual, con la dirección a la que apunta como cuerpo.
  • Lo que se rechaza: direcciones privadas y locales (10.x, 192.168.x, 127.0.0.1, 169.254.x y los equivalentes de IPv6), nombres como localhost o cualquier cosa bajo .local o .internal, un nombre que se resuelva a una de esas, los hosts propios de Cloudflare y de Mokxi, y cualquier host que hayamos tenido que detener. Tu sketch recibe un rechazo con el motivo en el panel Nube. WiFiClientSecure se sigue rechazando; usa un WiFiClient normal o ninguno.

Lo que guardamos

Conteos, y nada más: cuántas solicitudes envió hoy cada cuenta, proyecto y red, para que los límites diarios funcionen, y cuántas envió todo el servicio. Una red se cuenta bajo un código revuelto que cambia cada día, nunca su dirección. No se guarda ni registra ninguna dirección, URL, header ni cuerpo.

In a class

Para un estudiante de una clase, el internet real está desactivado a menos que el maestro lo active, sin importar el plan del estudiante. Un maestro con las herramientas de clase activadas (Pro, Salón de clases o la prueba) puede activarlo para un grupo, y el grupo entonces tiene los límites de Pro; hasta entonces el interruptor del estudiante indica que está desactivado para su grupo. Las cuentas marcadas como menores de 13 años siguen la misma regla.