10 Minutes to Complete Integration
-
1
PreparationReady
Below are the preparations needed before development
Log In / Sign Up for ThingBoot
You can sign up and log in with one tap using your mobile numberClick "Workbench" in the upper-right corner of this page
In the IoT console of the Workbench, you will manage, integrate, and debug devicesPrepare Your DevicesIf you have already purchased and received your devices, power them on and connect them to the network In the Support navigation, find the product manual for your device and follow the guide to connect it to the network
If you do not have a device, you can also integrate with the online demo devices You can find "Demo Devices" in the left navigation of the Workbench
-
2
Development SettingsSetting
After completing the preparation, configure the development settings first
Enter the Workbench, and in the left navigation of the IoT console, click "Development Settings"
Set your developer password (AppSecret) and keep a record of it, along with your developer ID (AppID)
For testing purposes only, you can enable "Debug Mode" In debug mode, the values of sign and ts are not checked, nor is the IP whitelist
For production-grade integration, do not enable it In this case, you need to compute the signature when writing your integration codeYou can ignore the other settings in Development Settings for now and explore them after integrating your first product
-
3
Start IntegrationCoding
Now you can start integrating your devices!
Before integrating, first open the device details pageUnder the "Devices" card in the console's left navigation
On the "Overview" card of the device details page, you can find the Product Manual for the device's product on the right side of the pageThe manual contains detailed device parameters, supported commands, installation instructions, and more
On the "Control" card of the device details page, you can try controlling the deviceWith each operation, you can see the command sent to the device at the top of the "Control" card page
Start Integration TestingIf "Debug Mode" is enabled Test Environment
You can use API debugging tools such as Postman to test device integration. For the specific request URL and POST command parameters, refer to the device's Product ManualIf "Debug Mode" is not enabled Production Environment
You only need to construct a simple HTTP request to control a device
The API uses the HTTP protocol, so any programming language capable of making HTTP requests will work;
The calling method is exactly the same for all devices — the approach is reusable across different devices, with only the commands differing. Therefore:For device control only:
You can simply encapsulate a single function, passing in the device ID (integer) and commands (array) as parametersFor other management operations:
You can encapsulate a class, with device control, grouping, scheduled tasks, and more as its methodsFor the specific request URL and POST command parameters, refer to the device's Product Manual