HEYQUANT / DOCUMENTATION

错误处理

区分服务响应、网络故障与本地文件错误。

HTTP 状态错误

客户端调用 raise_for_status()，捕获 httpx.HTTPStatusError 并抛出 HeyQuantError。消息包含 HTTP 状态码，以及非空响应正文。

网络与超时

网络错误与超时保持 httpx 异常类型。调用方应分别处理，并避免把含敏感响应内容的错误直接展示给其他用户。

import httpx
from heyquant import HeyQuantError

# 在已配置的 client 上调用
try:
    result = client.list_datasets()
except HeyQuantError:
    print("Service request failed")
except httpx.TimeoutException:
    print("Request timed out")
except httpx.RequestError:
    print("Network request failed")

重试与文件

公开 SDK 没有应用层自动重试或导出幂等机制。不要盲目重试创建导出请求。JSON 解析错误和本地文件错误需要由应用自行处理；下载中断后可能留下部分文件。