API 令牌 | Procurize.AI#

生成、管理并使用 API 令牌，以安全地以编程方式访问您的 Procurize.AI 工作区。

适用范围： Procurize.AI 仪表板 → 设置 → 令牌
可用计划： 商业版 & 企业版
所需角色： 管理员或维护者

概览#

API 令牌提供对 Procurize.AI 平台的安全、编程访问。您可以使用令牌将 Procurize.AI 与内部系统集成、自动化工作流，或在平台之上构建自定义应用。

关键特性：

• 令牌继承 创建者的全部权限
• 令牌是 组织范围 的 —— 调用 API 时无需指定 org
• 可以生成无限数量的令牌
• 令牌可以设置 过期日期 或设为永不过期
• 令牌可以 停用，并在需要时 重新激活

🔒 安全提示： Procurize.AI 不 存储令牌的明文值 —— 只存储其哈希。生成后必须立即复制并保存令牌，之后将不再显示。

访问令牌管理面板#

1. 前往 仪表板 → 设置 → 令牌 标签页。
2. 令牌管理面板会显示当前组织下与您关联的个人令牌。

所需权限： 仅 管理员 或 维护者 角色的用户可访问此面板。有关角色定义的详细信息，请参阅 权限概览 。

生成新令牌#

1. 输入 名称 以标识令牌的用途。

2. 选择 过期周期：

   • 1 个月
   • 3 个月
   • 1 年
   • 永不过期（无限有效）

3. 点击 “生成”。

重要 – 立即复制令牌#

生成后，令牌值 仅显示一次 —— 请立即复制并安全存储（例如在密码管理器或环境变量中）。

⚠️ 令牌值以后将无法再次查看。 Procurize.AI 仅存储安全哈希用于验证。若丢失令牌，请立即撤销并生成新令牌。

管理现有令牌#

令牌面板列出所有已生成的令牌及其：

• 名称
• 后缀
• 创建日期
• 过期日期（或 “-”）
• 状态：激活 或 未激活

停用 / 重新激活令牌#

• 停用 – 暂时禁用令牌。需要时可重新激活。
• 重新激活 – 将先前停用的令牌恢复为激活状态。

💡 停用功能适用于在不删除令牌的情况下暂时中止集成。

撤销令牌#

• 撤销 – 永久删除令牌，此操作不可撤回。
• 若令牌丢失，请立即撤销并生成新令牌。

使用 API 令牌#

基础 URL 与认证#

示例请求（cURL）#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 不需要组织 ID —— 令牌已绑定至您的组织，API 会自动解析上下文。

重要的安全与使用规则#

故障排查#

相关主题#

• 权限概览 – 详细的角色定义
• 定价计划 – 哪些计划包含 API 访问
• REST API 参考 – 详细的端点文档