使用tuya_iot库连接Tuya API时出现501错误请求失败

调用Tuya IoT Python库连接API时，执行授权登录请求返回错误码501，错误信息为request fail with unkown error，核心问题是请求体中country_code和schema为空字符串，属于必填参数缺失。以下是具体排查和修复步骤：

问题复现代码 #

from tuya_iot import TuyaOpenAPI, TUYA_LOGGER
import logging

TUYA_LOGGER.setLevel(logging.DEBUG)

# Cloud project authorization info
ACCESS_ID = 'mysuperID'
ACCESS_KEY = 'mysuperSecretKey'

ENDPOINT = "https://openapi.tuyaus.com" # Western America Data Center

# Project configuration
USERNAME = 'myemail@mail.com'
PASSWORD = 'thePassword of Tuya'

# Initialization of tuya openapi
openapi = TuyaOpenAPI(ENDPOINT, ACCESS_ID, ACCESS_KEY)
openapi.connect(USERNAME, PASSWORD)

错误日志 #

[2023-11-13 18:44:47,778] [tuya-openapi] Request: method = POST,                 url = https://openapi.tuyaus.com/v1.0/iot-01/associated-users/actions/authorized-login,                params = None,                body = {'username': 'myemail@mail.com', 'password': '***', 'country_code': '', 'schema': ''},                t = 1699911887778
[2023-11-13 18:44:48,694] [tuya-openapi] Response: {
  "code": 501,
  "msg": "request fail with unkown error",
  "success": false,
  "t": 1699911889502,
  "tid": "debb0af0826d11ee8088063dea7c5c23"
}

排查与修复步骤 #

• 补充必填参数：country_code（账号所属国家区号，美区填"1"，中国区填"86"）和schema（对应你使用的Tuya APP标识，个人账户一般填"tuyaSmart"或"smartlife"）是授权登录接口的必填项，原代码未传入导致请求不合法。修改connect调用：

  openapi.connect(USERNAME, PASSWORD, country_code="1", schema="tuyaSmart")
  

• 验证区域端点匹配：确认ENDPOINT与账号注册区域一致，美区用openapi.tuyaus.com，中国区用openapi.tuyacn.com，其他区域对应官方指定端点。
• 检查密钥有效性：确认ACCESS_ID和ACCESS_KEY来自Tuya开发者平台已上线的云项目，无过期或权限限制。
• 确认账号密码正确性：用该账号直接登录Tuya官方APP，验证密码是否正确。
• 排查网络环境：若在国内访问美西节点，尝试切换境外网络或检查代理/防火墙是否拦截请求。

修改后示例代码 #

from tuya_iot import TuyaOpenAPI, TUYA_LOGGER
import logging

TUYA_LOGGER.setLevel(logging.DEBUG)

ACCESS_ID = 'mysuperID'
ACCESS_KEY = 'mysuperSecretKey'
ENDPOINT = "https://openapi.tuyaus.com"
USERNAME = 'myemail@mail.com'
PASSWORD = 'thePassword of Tuya'

openapi = TuyaOpenAPI(ENDPOINT, ACCESS_ID, ACCESS_KEY)
# 补充必填参数
openapi.connect(USERNAME, PASSWORD, country_code="1", schema="tuyaSmart")

内容的提问来源于stack exchange，提问作者leadvic