Todos os caminhos

Projete uma API de dispositivo

Projete uma API HTTP para uma lâmpada no ESP32-C3: recursos, métodos, schemas JSON, erros, tokens e versões, terminando com docs e um teste de contrato.

ESP32-C3-DevKitM-1Grátis7 aulas6 h4 capítulos2.385 XPProgramação · Avançado+250 XP

0 de 7 concluídas

O que você vai montar

3 projetos, construídos passo a passo

7 aulas em 4 capítulos, cerca de 6 horas numa ESP32-C3-DevKitM-1 simulada. Grátis, no seu navegador, cada passo conferido pelo simulador.

Projeto do capítulo 1

Métodos

GET, PUT, PATCH, POST e DELETE numa lâmpada e numa coleção de horários: 201 com um Location, 204 ao apagar, 405 com um cabeçalho Allow, e quais métodos são seguros para repetir.

Abrir no simulador
Projeto do capítulo 2

Erros

400, 409, 422 e 503 de uma API de lâmpada, um Retry-After que diz quando tentar de novo e um único formato de erro para todos, incluindo o 404 que se esqueceu dele.

Abrir no simulador
Projeto do capítulo 3

Versionamento

Duas versões da API da lâmpada sobre uma lâmpada: uma renomeação que quebra compatibilidade ganha /v2, a versão antiga continua funcionando com uma data de Sunset, e um campo novo nem precisa de versão nova.

Abrir no simulador
O mapa

Capítulo por capítulo

Cada aula abre quando a anterior termina, e cada capítulo acaba num projeto.

Capítulo 1

O formato de uma API

Nomeie recursos com caminhos e diga o que fazer com métodos.

  1. Abrir227 XP

    Recursos e rotas

    Uma lâmpada com uma API HTTP: uma tabela de rotas, um console que envia requisições reais, substantivos no lugar de verbos, e por que um GET que liga a lâmpada é um bug.

    0 de 5 passos

  2. ProjetoBloqueado500 XP

    Métodos

    GET, PUT, PATCH, POST e DELETE numa lâmpada e numa coleção de horários: 201 com um Location, 204 ao apagar, 405 com um cabeçalho Allow, e quais métodos são seguros para repetir.

    0 de 5 passos

4 perguntas, com nota conforme você responde.
Capítulo 2

Contratos e falhas

Escreva o contrato do corpo, verifique-o e falhe em um único formato claro.

  1. Bloqueado250 XP

    Esquemas JSON

    O contrato da lâmpada escrito como JSON Schema, um PUT que verifica cada campo com as mesmas regras e responde 422 com cada problema, e o que fazer com um campo que você nunca pediu.

    0 de 5 passos

  2. ProjetoBloqueado454 XP

    Erros

    400, 409, 422 e 503 de uma API de lâmpada, um Retry-After que diz quando tentar de novo e um único formato de erro para todos, incluindo o 404 que se esqueceu dele.

    0 de 5 passos

4 perguntas, com nota conforme você responde.
Capítulo 3

Confiança e mudanças

Decida quem pode fazer o quê, e mude a API sem quebrar um cliente.

  1. Bloqueado227 XP

    Tokens de autenticação

    Tokens Bearer em uma API de lâmpada: 401 sem um, 403 com o errado, uma verificação no roteador que nenhum handler pode pular, tokens fora dos logs, e por que um token no firmware não é um segredo.

    0 de 5 passos

  2. ProjetoBloqueado500 XP

    Versionamento

    Duas versões da API da lâmpada sobre uma lâmpada: uma renomeação que quebra compatibilidade ganha /v2, a versão antiga continua funcionando com uma data de Sunset, e um campo novo nem precisa de versão nova.

    0 de 5 passos

4 perguntas, com nota conforme você responde.
Capítulo 4

Chefe: uma API de lâmpada documentada

Entregue a versão 1 com docs geradas, um teste de contrato e um guia.

  1. Bloqueado227 XP

    Chefe: uma API de lâmpada documentada

    A API de lâmpada completa, versão 1: rotas, métodos, um esquema verificado, um formato único de erro e tokens, com docs geradas a partir da tabela de rotas e uma suíte de testes de contrato que chama todas as rotas.

    0 de 5 passos

3 perguntas, corrigidas conforme você avança.
Certificado

Um certificado ao terminar

Termine todas as aulas e passe nos quizzes de todos os capítulos, e o Mokxi emitirá um certificado com o seu nome, verificado em sua própria página.

Certificado nºMXC0-URSE-0001

Certificado de Conclusão

Certificamos que

Nome do Aluno

concluiu com êxito o curso

Projete uma API de dispositivo

Abrangendo o formato de uma API, Contratos e falhas, Confiança e mudanças e Chefe: uma API de lâmpada documentada.

7 aulas · cerca de 6 horas de estudo

DaneDane, fundador do MokxiEmitido em 17 de novembro de 2026
Verificar este certificadomokxi.com/cert/MXC0URSE0001
Certificado

Ganhe seu certificado

  • Seu nome e um ID únicoImpresso em um certificado em modo paisagem que é seu para guardar.
  • Verificado pelo MokxiUm QR code e uma página pública com a qual qualquer pessoa pode conferir.
  • Adicionar ao LinkedInCom um clique, o formulário de certificação do LinkedIn é preenchido.
  • Baixar em PDFImprima ou anexe a um currículo ou a uma inscrição.

Termine o curso e ganhe um certificado verificável com seu nome, um QR code e um link para o LinkedIn. Os certificados acompanham o Pro, e o teste de 7 dias é grátis.

Programa do curso

Todas as aulas do curso

Todas as 7 aulas, em ordem, cada uma com o que cobre. Qualquer uma delas abre no editor na hora.

Capítulo 1

O formato de uma API

  1. Recursos e rotasUma lâmpada com uma API HTTP: uma tabela de rotas, um console que envia requisições reais, substantivos no lugar de verbos, e por que um GET que liga a lâmpada é um bug.
  2. MétodosGET, PUT, PATCH, POST e DELETE numa lâmpada e numa coleção de horários: 201 com um Location, 204 ao apagar, 405 com um cabeçalho Allow, e quais métodos são seguros para repetir.
Capítulo 2

Contratos e falhas

  1. Esquemas JSONO contrato da lâmpada escrito como JSON Schema, um PUT que verifica cada campo com as mesmas regras e responde 422 com cada problema, e o que fazer com um campo que você nunca pediu.
  2. Erros400, 409, 422 e 503 de uma API de lâmpada, um Retry-After que diz quando tentar de novo e um único formato de erro para todos, incluindo o 404 que se esqueceu dele.
Capítulo 3

Confiança e mudanças

  1. Tokens de autenticaçãoTokens Bearer em uma API de lâmpada: 401 sem um, 403 com o errado, uma verificação no roteador que nenhum handler pode pular, tokens fora dos logs, e por que um token no firmware não é um segredo.
  2. VersionamentoDuas versões da API da lâmpada sobre uma lâmpada: uma renomeação que quebra compatibilidade ganha /v2, a versão antiga continua funcionando com uma data de Sunset, e um campo novo nem precisa de versão nova.
Capítulo 4

Chefe: uma API de lâmpada documentada

  1. Chefe: uma API de lâmpada documentadaA API de lâmpada completa, versão 1: rotas, métodos, um esquema verificado, um formato único de erro e tokens, com docs geradas a partir da tabela de rotas e uma suíte de testes de contrato que chama todas as rotas.
Kits

Monte também na sua bancada

Cada aula roda no simulador, sem precisar comprar nada. Quando quiser a versão real, esses kits têm os componentes.

Já tem um kit?

Encontre seu kit

Escolha o kit inicial que você tem e rode todas as aulas do manual dele com os mesmos componentes nos mesmos pinos.

Ver todos os kits
Perguntas

Sobre Projete uma API de dispositivo

Projete uma API de dispositivo é grátis?

Sim. Todas as 7 aulas de Projete uma API de dispositivo são grátis e rodam no seu navegador, sem nada para instalar e sem componentes para comprar antes de começar.

Preciso de uma ESP32-C3-DevKitM-1 de verdade?

Não. Cada aula roda em uma ESP32-C3-DevKitM-1 simulada com seus componentes no canvas, e o simulador verifica cada passo conforme você avança. Quando você quiser montar de verdade, a mesma ligação e o mesmo código funcionam em uma placa real.

Quanto tempo dura Projete uma API de dispositivo?

Cerca de 6 horas: 7 aulas em 4 capítulos, cada uma com alguns passos curtos. Seu progresso fica salvo, então você pode parar depois de qualquer aula e continuar de onde parou.

O que eu vou montar?

Cada capítulo termina em um projeto que junta tudo: Métodos, Erros e Versionamento.

Por onde eu começo?

Comece com "Recursos e rotas", e cada aula se apoia na anterior. Novo em circuitos? Eletrônica básica é o curso que começa do zero.