Smartsheet Error Code 1006（404）求助：确认Sheet存在且ID正确仍无法访问

问题场景 #

调用Smartsheet Python SDK获取Sheet详情时，返回如下错误：

{"response": {"statusCode": 404, "reason": "Not Found", "content": {"errorCode": 1006, "message": "Not Found", "refId": "1lxywzbrqxdq6"}}}
Traceback (most recent call last):
  File "smartsheet_test.py", line 36, in <module>
    sheet_details = SMARTSHEET_OBJ.Sheets.get_sheet(SHEET_ID)
  File "/home/ubuntu/.local/lib/python3.6/site-packages/smartsheet/sheets.py", line 529, in get_sheet
    response = self._base.request(prepped_request, expected, _op)
  File "/home/ubuntu/.local/lib/python3.6/site-packages/smartsheet/smartsheet.py", line 250, in request
    raise the_ex(native, str(native.result.code) + ': ' + native.result.message)
smartsheet.exceptions.ApiError: {"result": {"code": 1006, "errorCode": 1006, "message": "Not Found", "name": "ApiError", "recommendation": "Do not retry without fixing the problem. ", "refId": "1lxywzbrqxdq6", "shouldRetry": false, "statusCode": 404}}

使用的代码：

import smartsheet
from config import SHEET_ID, access_token

SMARTSHEET_OBJ = smartsheet.Smartsheet(access_token=access_token)
SMARTSHEET_OBJ.errors_as_exceptions(True)

sheet_details = SMARTSHEET_OBJ.Sheets.get_sheet(SHEET_ID)

已确认目标Sheet存在、SHEET_ID正确，使用的Smartsheet SDK版本为2.105.1。

排查方向 #

• 验证访问令牌的权限范围
  确认access_token对应的账号拥有目标Sheet的访问权限：

  • 手动登录Smartsheet网页端，检查账号是否是Sheet的共享成员，或Sheet所在工作区的成员
  • 用以下代码列出当前账号可访问的所有Sheet，确认目标Sheet在列表内：

    sheets = SMARTSHEET_OBJ.Sheets.list_sheets(include_all=True)
    for sheet in sheets.data:
        print(f"Sheet ID: {sheet.id}, Name: {sheet.name}")
    

• 检查SHEET_ID的类型
  确保SHEET_ID是整数类型，而非字符串。如果配置文件中SHEET_ID以字符串形式存储，API会无法识别。可以在代码中添加print(type(SHEET_ID))验证类型。

• 确认API环境一致性
  如果使用的是沙箱环境的令牌，而Sheet在生产环境（反之亦然），会出现找不到的情况。初始化Smartsheet对象时可指定环境：

  # 沙箱环境
  SMARTSHEET_OBJ = smartsheet.Smartsheet(access_token=access_token, base_url="https://api.smartsheet.com/2.0/sandbox")
  # 生产环境（默认）
  SMARTSHEET_OBJ = smartsheet.Smartsheet(access_token=access_token)
  

• 检查Sheet的状态和位置
  即使Sheet存在，若被移动到账号无权访问的文件夹/工作区，或被归档，API也会返回1006。手动登录网页端确认Sheet的位置和状态。

• 升级/降级SDK版本
  版本2.105.1可能存在兼容性问题，尝试升级到最新版本：

  pip install --upgrade smartsheet
  

  或降级到稳定版本（如2.100.0）测试。

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