tuya / tuya-connector-python

The tuya-connector-python SDK is designed to support open APIs and Pulsar messages provided by Tuya.

tuya-connector-python

The tuya-connector-python SDK is designed to support openAPIs and Pulsar messages provided by Tuya. Before using this SDK, you can see Quick Start on the Tuya Developer website to learn more about Cloud Development Platform.

Install

pip3 install tuya-connector-python

Get started

1. Sign up for Tuya developer account.

2. Create a cloud project. See the tutorial for how to get the authorization key and other necessary parameters.

3. A quick example is as follows:

   from tuya_connector import (
   	TuyaOpenAPI,
   	TuyaOpenPulsar,
   	TuyaCloudPulsarTopic,
   )
   
   ACCESS_ID = "your-access-id"
   ACCESS_KEY = "your-access-key"
   API_ENDPOINT = "https://openapi.tuyacn.com"
   MQ_ENDPOINT = "wss://mqe.tuyacn.com:8285/"
   
   # Init OpenAPI and connect
   openapi = TuyaOpenAPI(API_ENDPOINT, ACCESS_ID, ACCESS_KEY)
   openapi.connect()
   
   # Call any API from Tuya
   response = openapi.get("/v1.0/statistics-datas-survey", dict())
   
   # Init Message Queue
   open_pulsar = TuyaOpenPulsar(
   	ACCESS_ID, ACCESS_KEY, MQ_ENDPOINT, TuyaCloudPulsarTopic.PROD
   )
   # Add Message Queue listener
   open_pulsar.add_message_listener(lambda msg: print(f"---\nexample receive: {msg}"))
   
   # Start Message Queue
   open_pulsar.start()
   
   input()
   # Stop Message Queue
   open_pulsar.stop()

OpenAPI reference

Tuya opens up a variety of APIs covering scenarios such as device pairing, asset management, and device control. You can call APIs according to API reference to create IoT applications.

Feedback

If you have any questions, please provide feedback via Github Issue or Technical Ticket.

License

The tuya-connector-python SDK is available under the MIT license. For more information, see the LICENSE file.