如何获取ActiveCollab API issue-token-intent端点必填参数的取值？

问题梳理 #

• 官方API文档中未找到issue-token-intent端点的intent、client_name、client_vendor参数说明
• 按第三方指南完成第1步，但不清楚第1步返回值与第2步的关联逻辑
• 最终目标：获取access/authorisation token

1. issue-token-intent端点参数说明 #

结合ActiveCollab OAuth流程的实际使用场景，这三个参数的作用如下：

• intent：固定传入issue-token，用于标识当前请求的核心目的是申请授权令牌
• client_name：填写你的应用名称，方便在ActiveCollab后台识别第三方应用身份
• client_vendor：填写你的开发者/组织名称，作为应用归属的标识信息

2. 步骤1与步骤2的关联逻辑 #

假设你第1步调用的是获取令牌意向的接口（比如get-token-intent），返回结果中会包含一个唯一的intent_id（或类似字段）。这个值需要在第2步调用issue-token-intent时传入，用于验证请求的连贯性，证明你是合法的令牌意向发起者。

以下是简化的请求示例：

# 第1步：获取令牌意向标识
curl -X GET "https://你的ActiveCollab域名/api/v1/get-token-intent" \
  -H "Content-Type: application/json" \
  -d '{"email": "你的账号邮箱", "password": "你的账号密码"}'

# 返回示例（核心字段为intent_id）
{"intent_id": "abc123xyz", "user_id": 123}

# 第2步：传入标识申请令牌
curl -X POST "https://你的ActiveCollab域名/api/v1/issue-token-intent" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "issue-token",
    "client_name": "我的自定义应用",
    "client_vendor": "我的组织名称",
    "intent_id": "abc123xyz"
  }'

3. 额外验证建议 #

• 可以抓取ActiveCollab官方客户端的请求包，对照查看该端点的实际参数结构
• 确保请求的域名、API版本与你的ActiveCollab实例完全匹配，不同版本可能存在端点差异

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