金蝶云星空旗舰版连接器参数获取指引说明

以下是针对您所需7个连接器参数的官方标准获取步骤，操作前请确保您拥有系统管理员（Administrator）权限，并已完成OpenAPI开放平台初始化配置。

—

一、服务器地址（Server URL）

定义：金蝶云星空旗舰版系统的访问地址，私有云需配置完整产品地址，公有云使用官方域名。

获取步骤：

1. 打开浏览器，访问您日常登录金蝶云星空旗舰版的网址
2. 复制完整地址（私有云通常以K3Cloud/结尾，如http://192.168.1.100:8080/K3Cloud/；公有云如https://xxx.kingdee.com/K3Cloud/）
3. 注意：无需包含登录后的具体页面路径，只需到K3Cloud/层级

验证方式：在浏览器中访问该地址，应能正常进入金蝶云星空登录界面

—

二、appId/client_id（应用ID/系统编码）

定义：第三方应用的唯一标识，在金蝶云星空开放平台注册后自动生成。

获取步骤：

1. 以管理员身份登录金蝶云星空旗舰版系统
2. 进入菜单：【开放服务云】→【OpenAPI】→【第三方系统登录授权】
3. 点击【新增】按钮，填写应用基本信息（应用名称、用途等）
4. 点击【获取应用ID】→【复制网址】，跳转到金蝶云官网登录并完成授权
5. 返回系统，自动生成appId（系统编码），可直接复制使用

注意事项：应用ID不会过期，可在应用编辑页面查看和管理

—

三、AccessToken认证密钥（应用密钥/系统密码）

定义：用于AccessToken认证的密钥，需手动设置并妥善保存，不支持后续查看。

获取步骤：

1. 在【第三方系统登录授权】的应用详情页面，找到【访问策略】区域
2. 点击【编辑】按钮，开启【增强型Token认证】开关
3. 设置认证密钥（建议使用复杂密码，包含大小写字母、数字和特殊字符）
4. 点击【保存】，立即记录并安全存档该密钥（此为唯一查看机会）
5. 如需重置，可在应用编辑页面找到【重置密钥】功能

—

四、代理用户用户名

定义：用于第三方系统访问的代理用户账号，需具备相应的数据访问权限。

获取步骤：

1. 在【第三方系统登录授权】的应用详情页面，开启【启用代理用户控制】开关
2. 在【代理用户】输入框中，选择或输入已存在的金蝶云星空用户账号
3. 确保该用户已被授予所需业务模块的访问权限（建议单独创建集成专用用户）
4. 点击【保存】，该用户名即为代理用户用户名

安全建议：

• 避免使用管理员账号作为代理用户
• 按最小权限原则配置该用户的功能权限和数据权限

—

五、accountId账套ID（数据中心ID）

定义：金蝶云星空系统中账套（数据中心）的唯一标识，用于区分不同的业务数据环境。

获取方式（三种可选）：

—

六、语言（默认zh_CN）

定义：系统交互语言，默认使用中文简体（zh_CN），支持其他语言（如en_US英文）。

设置方式：

1. 通常在连接器配置中直接选择或输入语言代码
2. 金蝶云星空旗舰版支持的语言包括：zh_CN（中文简体）、zh_TW（中文繁体）、en_US（英文）等
3. 如无特殊需求，保持默认值zh_CN即可

—

七、x-acgw-identity（身份标识）

定义：API请求头中必须携带的公共参数，用于标识请求来源，从产品端内获取。

获取步骤：

1. 在【第三方系统登录授权】的应用详情页面，找到【认证凭证】区域
2. 直接复制x-acgw-identity值（系统自动生成，与应用和账套绑定）
3. 在API请求时，将该值添加到请求头中，格式：x-acgw-identity: [获取到的值]

重要提示：面向金蝶云星空旗舰版发起的API调用，必须携带此参数，否则请求将被拒绝

—

八、整体操作流程总结

1. 准备工作：确保拥有管理员权限，完成OpenAPI初始化
2. 创建第三方应用：获取appId和x-acgw-identity
3. 配置访问策略：设置AccessToken认证密钥，启用代理用户控制
4. 获取账套信息：通过MC或应用凭证获取accountId
5. 收集服务器地址和代理用户信息，完成全部参数配置

九、常见问题与注意事项

1. 参数保存：所有参数（特别是认证密钥）需妥善保存，建议使用密码管理器存储
2. 权限问题：确保管理员账号拥有【第三方系统登录授权】功能的访问权限
3. API调用：参数配置完成后，建议先通过API测试工具验证连接是否正常
4. 安全最佳实践：定期更新认证密钥，限制代理用户权限，监控第三方应用访问日志
5. 官方文档：具体细节请以金蝶云星空旗舰版官方文档和帮助中心说明为准