如何为特定Catalyst组织生成调用REST API的访问令牌？

为特定组织生成访问令牌 #

方法1：使用个人访问令牌（PAT） #

• 登录Catalyst控制台，手动切换到目标组织
• 进入个人设置页面，找到「API令牌」选项
• 点击「生成新令牌」，设置令牌名称、有效期，勾选该组织所需的API权限
• 生成后复制保存令牌，调用API时在请求头中添加：

  Authorization: Zoho-oauthtoken <你的PAT令牌>
  

  该令牌仅关联当前切换的组织，所有API请求都会作用于该组织。

方法2：使用组织级OAuth令牌 #

如果需要用OAuth流程生成特定组织的令牌，需按以下步骤操作：

• 创建OAuth客户端时，选择「特定组织」类型，并绑定目标组织
• 走标准OAuth授权码流程：
  1. 构造授权URL，确保用户在授权前已切换到目标组织
  2. 获取授权码后，调用令牌生成接口，传入client_id、client_secret、code和grant_type=authorization_code
  3. 生成的令牌将仅对绑定的目标组织生效

解决无法生成特定组织OAuth令牌的问题 #

以下是常见问题及修复方案：

• 客户端组织绑定错误：
  若OAuth客户端创建时选了「所有组织」，则无法生成特定组织的令牌。需重新创建客户端，选择「特定组织」并指定目标组织。
• 授权流程未切换组织：
  在跳转授权页面之前，必须确保用户已在Catalyst控制台切换到目标组织，否则授权码会关联默认组织，导致令牌无法访问目标组织。
• 权限范围不匹配：
  请求授权时，需包含目标组织所需的API权限范围（例如ZohoCatalyst.projects.write），缺少权限会导致令牌生成后无法正常调用对应API。
• 令牌请求参数错误：
  调用令牌接口时，不要额外传入组织ID参数（特定组织客户端已绑定组织），否则会导致参数冲突。
• 组织状态异常：
  确认目标组织处于活跃状态，未被暂停或删除，否则无法生成对应令牌。

内容的提问来源于stack exchange，提问作者Santhosh Kumar M