使用Zoho Catalyst Node SDK调用SmartBrowz生成PDF时遇401权限错误

遇到这个权限不匹配的401错误，核心原因是当前认证令牌缺少访问SmartBrowz服务的必要权限，按以下步骤排查修复：

• 检查项目OAuth权限配置
  登录Catalyst控制台，进入你的项目，找到Settings > OAuth Scopes，确认已添加ZohoCatalyst.SmartBrowz.Read和ZohoCatalyst.SmartBrowz.Write权限（生成PDF必须要有Write权限）。如果权限缺失，添加后保存配置。

• 重新认证本地CLI
  在本地终端执行catalyst login重新登录Zoho账号，确保CLI获取的最新令牌包含正确权限。可以用catalyst auth:status命令查看当前认证的权限列表，确认SmartBrowz相关权限已在列。

• 修正SDK初始化代码
  检查Node SDK的初始化代码，不要手动指定不包含SmartBrowz权限的scopes参数。正确的初始化方式如下：

  const catalyst = require('zcatalyst-sdk-node');
  const app = catalyst.initialize();
  

  如果必须自定义scopes，一定要把ZohoCatalyst.SmartBrowz.Read和ZohoCatalyst.SmartBrowz.Write加入列表。

• 确认SmartBrowz服务已启用
  进入Catalyst控制台的Services > SmartBrowz页面，确认服务已启用且项目所在区域支持该服务。未启用的话点击启用，等待服务初始化完成后再重试调用。

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