Todas las rutas

Diseña una API para un dispositivo

Diseña una API HTTP para una lámpara en un ESP32-C3: recursos, métodos, esquemas JSON, errores, tokens y versiones, terminando con documentación y una prueba de contrato.

ESP32-C3-DevKitM-1Gratis7 lecciones6 h4 capítulos2,385 XPProgramación · Avanzado+250 XP

0 de 7 completadas

Lo que vas a construir

3 proyectos, construidos paso a paso

7 lecciones en 4 capítulos, unas 6 horas en un ESP32-C3-DevKitM-1 simulado. Gratis, en tu navegador, cada paso verificado por el simulador.

Proyecto del capítulo 1

Métodos

GET, PUT, PATCH, POST y DELETE sobre una lámpara y una colección de horarios: 201 con una cabecera Location, 204 al borrar, 405 con una cabecera Allow, y qué métodos son seguros de repetir.

Ábrelo en el simulador
Proyecto del capítulo 2

Errores

400, 409, 422 y 503 desde una API de lámpara, un Retry-After que indica cuándo volver a intentar, y una sola forma de error para todos, incluido el 404 que la olvidó.

Ábrelo en el simulador
Proyecto del capítulo 3

Versionado

Dos versiones de la API de la lámpara sobre una misma lámpara: un cambio de nombre incompatible obtiene /v2, la versión vieja sigue funcionando con una fecha de Sunset, y un campo agregado no necesita ninguna versión nueva.

Ábrelo en el simulador
El mapa

Capítulo por capítulo

Cada lección se abre cuando termina la anterior, y cada capítulo termina en un proyecto.

Capítulo 1

La forma de una API

Nombra los recursos con rutas y di qué hacer con los métodos.

  1. Abrir227 XP

    Recursos y rutas

    Una lámpara con una API HTTP: una tabla de rutas, una consola que envía solicitudes reales, sustantivos en lugar de verbos, y por qué un GET que enciende la lámpara es un bug.

    0 de 5 pasos

  2. ProyectoBloqueado500 XP

    Métodos

    GET, PUT, PATCH, POST y DELETE sobre una lámpara y una colección de horarios: 201 con una cabecera Location, 204 al borrar, 405 con una cabecera Allow, y qué métodos son seguros de repetir.

    0 de 5 pasos

4 preguntas, calificadas conforme avanzas.
Capítulo 2

Contratos y fallas

Escribe el contrato del body, verifícalo y falla con una sola forma clara.

  1. Bloqueado250 XP

    Esquemas JSON

    El contrato de la lámpara escrito como JSON Schema, un PUT que verifica cada campo con las mismas reglas y responde 422 con cada problema, y qué hacer con un campo que nunca pediste.

    0 de 5 pasos

  2. ProyectoBloqueado454 XP

    Errores

    400, 409, 422 y 503 desde una API de lámpara, un Retry-After que indica cuándo volver a intentar, y una sola forma de error para todos, incluido el 404 que la olvidó.

    0 de 5 pasos

4 preguntas, calificadas conforme avanzas.
Capítulo 3

Confianza y cambios

Decide quién puede hacer qué, y cambia la API sin romper un cliente.

  1. Bloqueado227 XP

    Tokens de autenticación

    Tokens Bearer en una API de lámpara: 401 sin uno, 403 con uno equivocado, una verificación en el router que ningún handler puede saltarse, tokens fuera de los logs, y por qué un token en el firmware no es un secreto.

    0 de 5 pasos

  2. ProyectoBloqueado500 XP

    Versionado

    Dos versiones de la API de la lámpara sobre una misma lámpara: un cambio de nombre incompatible obtiene /v2, la versión vieja sigue funcionando con una fecha de Sunset, y un campo agregado no necesita ninguna versión nueva.

    0 de 5 pasos

4 preguntas, calificadas conforme avanzas.
Capítulo 4

Jefe final: una API de lámpara documentada

Publica la versión 1 con documentación generada, una prueba de contrato y una guía.

  1. Bloqueado227 XP

    Jefe final: una API de lámpara documentada

    Toda la API de la lámpara, versión 1: rutas, métodos, un esquema verificado, una sola forma de error y tokens, con documentación generada a partir de la tabla de rutas y una suite de pruebas de contrato que llama a cada ruta.

    0 de 5 pasos

3 preguntas, calificadas al momento.
Certificado

Un certificado al terminar

Termina todas las lecciones y aprueba todos los cuestionarios de capítulo, y Mokxi te emite un certificado con tu nombre, verificado en su propia página.

Certificado n.ºMXC0-URSE-0001

Certificado de Finalización

Se certifica que

Tu Nombre

ha completado con éxito el curso

Diseña una API para un dispositivo

Cubre la forma de una API, Contratos y fallas, Confianza y cambios y Jefe final: una API de lámpara documentada.

7 lecciones · unas 6 horas de estudio

DaneDane, Fundador, MokxiEmitido el 17 de noviembre de 2026
Verificar este certificadomokxi.com/cert/MXC0URSE0001
Certificado

Gana tu certificado

  • Tu nombre y un ID únicoImpreso en un certificado horizontal que es tuyo para siempre.
  • Verificado por MokxiUn código QR y una página pública con la que cualquiera puede comprobarlo.
  • Agregar a LinkedInUn clic llena el formulario de certificaciones de LinkedIn.
  • Descargar como PDFImprímelo o adjúntalo a un currículum o a una solicitud.

Termina el curso y gana un certificado verificable con tu nombre, un código QR y un enlace para LinkedIn. Los certificados vienen con Pro, y la prueba gratis de 7 días no te cuesta nada.

Temario

Todas las lecciones del curso

Las 7 lecciones, en orden, cada una con lo que abarca. Cualquiera se abre en el editor de inmediato.

Capítulo 1

La forma de una API

  1. Recursos y rutasUna lámpara con una API HTTP: una tabla de rutas, una consola que envía solicitudes reales, sustantivos en lugar de verbos, y por qué un GET que enciende la lámpara es un bug.
  2. MétodosGET, PUT, PATCH, POST y DELETE sobre una lámpara y una colección de horarios: 201 con una cabecera Location, 204 al borrar, 405 con una cabecera Allow, y qué métodos son seguros de repetir.
Capítulo 2

Contratos y fallas

  1. Esquemas JSONEl contrato de la lámpara escrito como JSON Schema, un PUT que verifica cada campo con las mismas reglas y responde 422 con cada problema, y qué hacer con un campo que nunca pediste.
  2. Errores400, 409, 422 y 503 desde una API de lámpara, un Retry-After que indica cuándo volver a intentar, y una sola forma de error para todos, incluido el 404 que la olvidó.
Capítulo 3

Confianza y cambios

  1. Tokens de autenticaciónTokens Bearer en una API de lámpara: 401 sin uno, 403 con uno equivocado, una verificación en el router que ningún handler puede saltarse, tokens fuera de los logs, y por qué un token en el firmware no es un secreto.
  2. VersionadoDos versiones de la API de la lámpara sobre una misma lámpara: un cambio de nombre incompatible obtiene /v2, la versión vieja sigue funcionando con una fecha de Sunset, y un campo agregado no necesita ninguna versión nueva.
Capítulo 4

Jefe final: una API de lámpara documentada

  1. Jefe final: una API de lámpara documentadaToda la API de la lámpara, versión 1: rutas, métodos, un esquema verificado, una sola forma de error y tokens, con documentación generada a partir de la tabla de rutas y una suite de pruebas de contrato que llama a cada ruta.
Kits

Armélo también en tu banco de trabajo

Cada lección funciona en el simulador sin comprar nada. Cuando quieras lo real, estos kits tienen los componentes.

¿Ya tienes un kit?

Encuentra tu kit

Elige el kit inicial que tienes y ejecuta cada lección de su instructivo con los mismos componentes en los mismos pines.

Ver todos los kits
Preguntas

Acerca de Diseña una API para un dispositivo

¿Diseña una API para un dispositivo es gratis?

Sí. Las 7 lecciones de Diseña una API para un dispositivo son gratis y corren en tu navegador, sin nada que instalar y sin componentes que comprar antes de empezar.

¿Necesito una ESP32-C3-DevKitM-1 real?

No. Cada lección corre en una ESP32-C3-DevKitM-1 simulada con sus componentes en el lienzo, y el simulador verifica cada paso conforme avanzas. Cuando quieras armarlo de verdad, el mismo cableado y código funcionan en una placa real.

¿Cuánto dura Diseña una API para un dispositivo?

Unas 6 horas: 7 lecciones en 4 capítulos, cada una de unos pasos cortos. Tu progreso se guarda, así que puedes parar después de cualquier lección y retomar donde lo dejaste.

¿Qué voy a armar?

Cada capítulo termina con un proyecto que lo integra todo: Métodos, Errores y Versionado.

¿Por dónde empiezo?

Con "Recursos y rutas", y cada lección se construye sobre la anterior. ¿Nuevo en los circuitos? Fundamentos de electrónica es el curso que empieza desde cero.