Sonoff MINI & R3 Smart Switches Support a DIY REST API

ITEAD Studio’s Sonoff are low-cost wireless switches based on ESP8622/ESP8285 WiSoC, and supporting WiFi and/or 433 MHz connectivity. They usually come with a firmware that allows users to control them with eWelink app for Android or iOS. But many people will install alternative open source firmware such as Sonoff-Tasmota or ESPurna to get more flexibility such as the ability to use MQTT.

But the company’s latest models, including Sonoff MINI and R3 series, implement a “DIY” REST API that allows you to control the device, or flash the firmware over a LAN connection.

Sonoff MINI two-way Smart Switch

Sonoff MINISonoff MINI is designed to be installed behind existing wall-mounted light-switches and wall-mounted power-sockets.


  • Terminal blocks with 6x inputs/outputs:
    • N/L Inputs –  AC 100-240V 50/60Hz 10A Max
    • N/L Outputs – AC 100-240V 50/60Hz 10A Max
    • S1/S2 – Designed to optionally connect a standard on/off switch
  • Connectivity – Wi-Fi 4 – 802.11 b/g/n @ 2.4GHz; external wire-antenna
  • Dimensions – 42.6X42.6X20mm (Material: PC V0)

Sonoff mini still works with eWeLink app, Google Assistant and/or Amazon Alexa voice services, like its predecessor such as Sonoff Basic, but as mentioned above it also supports a DIY mode (REST API) that should allow developers to integrate MINI into third-party open source smart home control system such as Home Assistant, openHAB, ioBroker, etc…

Sonoff MINI Wiring Diagram
Wiring with or without external On/Off switch

Sonoff MINI is sold for $8.90 plus shipping on ITEAD Studio store.

Sonoff R3Basic and RFR3

Sonoff RFR3Specifications:

  • Terminal blocks with 2x inputs for Neutral and Live, and 2x outputs
  • Max Current – 10A
  • Max Power –  2200W
  • Input/Output Voltage – AC 100-240V
  • Connectivity
    • WiFi 4 802.11 b/g/n 2.4GHz
    • Sonoff RFR3 only – 433.92MHz radio
  • Dimensions – 91x43x25 mm (Material: PC V0)

Sonoff BasicR3 is a simpler device since it does not support connection to an external On/Off switch and Sonoff RFR3 is similar but adds support for 433 MHz remote control.

Sonoff DIY Mode REST API

Software-wise, both support the same features as Sonoff MINI with eWelink app and the DIY REST API. You’ll find the tools and documentation for the latter on Github.

Sonoff BasicR3 sells for $4.85 only, while Sonoff RFR3 goes for $7.20,  and you may consider adding $4.50 for a 4-button RF remote control. You’ll also find quick and user guide on the respective pages.

Thanks to Andreas for the tip.

Share this:

Support CNX Software! Donate via cryptocurrencies or become a Patron on Patreon

ROCK Pi 4C Plus
Notify of
The comment form collects your name, email and content to allow us keep track of the comments placed on the website. Please read and accept our website Terms and Privacy Policy to post a comment.
Weller PCB manufacturer