10 Minutes to Complete Integration

  1. 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 number
    Click "Workbench" in the upper-right corner of this page
    In the IoT console of the Workbench, you will manage, integrate, and debug devices
    Prepare Your Devices

    If 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. 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 code

    You can ignore the other settings in Development Settings for now and explore them after integrating your first product


  3. 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 Testing
    If "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 Manual
    If "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 parameters
    For other management operations:
    You can encapsulate a class, with device control, grouping, scheduled tasks, and more as its methods
    For the specific request URL and POST command parameters, refer to the device's Product Manual
For the complete platform API reference, see:
Open Platform API Documentation
For the command parameters supported by a device, see: