{"id":28341,"library":"tencentcloud-sdk-python-iotexplorer","title":"Tencent Cloud IoT Explorer SDK for Python","description":"Official Tencent Cloud SDK for the IoT Explorer service (explorer module). Current version 3.1.89, released 2025-05-09. Follows monthly release cadence synced with parent tencentcloud-sdk-python. Provides client classes for device management, data reporting, rule engine, and OTA.","status":"active","version":"3.1.89","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python","tags":["tencent","iot","explorer","tencent-cloud","sdk"],"install":[{"cmd":"pip install tencentcloud-sdk-python-iotexplorer","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Shared authentication, HTTP transport, and credential handling","package":"tencentcloud-sdk-python-common","optional":false}],"imports":[{"note":"SDK uses versioned submodules (v20190423). Omitting version causes import error.","wrong":"from tencentcloud.iotexplorer import IotexplorerClient","symbol":"IotexplorerClient","correct":"from tencentcloud.iotexplorer.v20190423 import iotexplorer_client"},{"note":"Models must also use the versioned import path.","wrong":"from tencentcloud.iotexplorer import models","symbol":"models","correct":"from tencentcloud.iotexplorer.v20190423 import models"}],"quickstart":{"code":"import os\nfrom tencentcloud.common import credential\nfrom tencentcloud.iotexplorer.v20190423 import iotexplorer_client, models\n\n# Authentication from environment variables\ncred = credential.Credential(\n    os.environ.get('TENCENTCLOUD_SECRET_ID', ''),\n    os.environ.get('TENCENTCLOUD_SECRET_KEY', '')\n)\nclient = iotexplorer_client.IotexplorerClient(cred, 'ap-guangzhou')\n\n# Example: describe a device\nreq = models.DescribeDeviceRequest()\nreq.ProductId = 'YOUR_PRODUCT_ID'\nreq.DeviceName = 'YOUR_DEVICE_NAME'\ntry:\n    resp = client.DescribeDevice(req)\n    print(resp.to_json_string())\nexcept Exception as e:\n    print('Error:', e)","lang":"python","description":"Creates a client, authenticates via env vars, and describes a device."},"warnings":[{"fix":"Use async/await pattern or wrap in asyncio.run(). Example: resp = await client.DescribeDevice(req)","message":"SDK v3 removed synchronous client methods; all API calls are now async. Use await or set run_async=False (deprecated).","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Always use: from tencentcloud.iotexplorer.v20190423 import ...","message":"Versioned import paths (v20190423) are strictly required. Omitting the version causes ModuleNotFoundError.","severity":"gotcha","affected_versions":"all"},{"fix":"Pass region string to client constructor, e.g., IotexplorerClient(cred, 'ap-guangzhou')","message":"Region endpoint must be specified; SDK does not default to global endpoint. Use 'ap-guangzhou' (Guangzhou) or your project region.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run: pip install tencentcloud-sdk-python-iotexplorer (installs common automatically). If using monorepo, install tencentcloud-sdk-python-common explicitly.","cause":"Missing common package or incorrect install order.","error":"ModuleNotFoundError: No module named 'tencentcloud'"},{"fix":"Use one of: ap-guangzhou, ap-shanghai, ap-beijing, ap-singapore. Check official docs for full list.","cause":"Region not supported by IoT Explorer service.","error":"tencentcloud.common.exception.TencentCloudSDKException: UnsupportedRegion"},{"fix":"Ensure you imported from tencentcloud.iotexplorer.v20190423 and version is >=3.0.0.","cause":"Wrong import path or old SDK version that uses different method names.","error":"AttributeError: 'IotexplorerClient' object has no attribute 'DescribeDevice'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}