xts-pythonclient-api-sdk对接IIFL算法交易凭证无效问题排查

问题根因拆解 #

• 凭证无效报错的直接触发点：自定义API域名未传入SDK实例
  你在示例代码中定义的XTS_API_BASE_URL是孤立的全局变量，XTSConnect初始化流程不会自动读取该值。SDK实际使用的是config.ini中读取的默认根地址，因请求目标域名与你持有的API凭证所属环境不匹配，服务端校验时判定凭证无效。
• 全链路鉴权失败的连锁反应：登录流程未拿到有效token
  第一步登录请求失败后，SDK实例的self.token始终保持初始None值，后续所有请求的请求头不会携带Authorization字段，直接触发服务端“请提供token鉴权”的报错。
• SDK内部两个连锁代码缺陷：
  1. marketdata_login方法异常捕获逻辑存在漏洞：若self._post(...)请求阶段直接抛出异常，方法作用域内的response变量未完成初始化，进入except分支后访问response['description']就会触发UnboundLocalError
  2. _request方法处理Bad Request错误时未做类型兼容：默认将data['result']['errors']按字符串类型拼接，但实际服务端返回该字段为列表类型，直接触发TypeError: must be str, not list

分步修复步骤 #

• 修正XTSConnect实例化逻辑，显式传入正确的API根地址：
  修改初始化代码为：

  xt = XTSConnect(
      apiKey=API_KEY,
      secretKey=API_SECRET,
      source=source,
      root=XTS_API_BASE_URL  # 显式将自定义API域名传入构造函数
  )
  

• 修复SDK内部的代码缺陷：
  1. 调整marketdata_login的异常捕获逻辑，在方法初始化阶段预置response变量，避免未定义引用：
     将方法内代码修改为：

     def marketdata_login(self):
         response = None
         try:
             params = {
                 "appKey": self.apiKey,
                 "secretKey": self.secretKey,
                 "source": self.source
             }
             response = self._post("market.login", params)
             if "token" in response.get('result', {}):
                 self._set_common_variables(response['result']['token'], response['result']['userID'])
             return response
         except Exception as e:
             return response['description'] if response else str(e)
     

  2. 调整_request方法的错误拼接逻辑，兼容errors字段的列表类型：
     将错误拼接代码修改为：

     if r.status_code == 400 and data["type"] == "error" and data["description"] == "Bad Request":
         errors = data['result']["errors"]
         errors_str = "; ".join(errors) if isinstance(errors, list) else str(errors)
         message = "Description: " + data["description"] + " errors: " + errors_str
         raise ex.XTSInputException(str(message))
     

• 验证修复效果：
  修复后重新运行示例代码，首先确认marketdata_login接口返回200状态码且包含有效token，后续所有行情接口的鉴权流程会自动携带token，不会触发未授权报错。

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