金蝶云星空旗舰版连接器参数获取指引说明
以下是针对您所需7个连接器参数的官方标准获取步骤,操作前请确保您拥有系统管理员(Administrator)权限,并已完成OpenAPI开放平台初始化配置。
—
一、服务器地址(Server URL)
定义:金蝶云星空旗舰版系统的访问地址,私有云需配置完整产品地址,公有云使用官方域名。
获取步骤:
- 打开浏览器,访问您日常登录金蝶云星空旗舰版的网址
- 复制完整地址(私有云通常以
K3Cloud/结尾,如http://192.168.1.100:8080/K3Cloud/;公有云如https://xxx.kingdee.com/K3Cloud/)
- 注意:无需包含登录后的具体页面路径,只需到
K3Cloud/层级
验证方式:在浏览器中访问该地址,应能正常进入金蝶云星空登录界面
—
二、appId/client_id(应用ID/系统编码)
定义:第三方应用的唯一标识,在金蝶云星空开放平台注册后自动生成。
获取步骤:
- 以管理员身份登录金蝶云星空旗舰版系统
- 进入菜单:【开放服务云】→【OpenAPI】→【第三方系统登录授权】
- 点击【新增】按钮,填写应用基本信息(应用名称、用途等)
- 点击【获取应用ID】→【复制网址】,跳转到金蝶云官网登录并完成授权
- 返回系统,自动生成appId(系统编码),可直接复制使用
注意事项:应用ID不会过期,可在应用编辑页面查看和管理
—
三、AccessToken认证密钥(应用密钥/系统密码)
定义:用于AccessToken认证的密钥,需手动设置并妥善保存,不支持后续查看。
获取步骤:
- 在【第三方系统登录授权】的应用详情页面,找到【访问策略】区域
- 点击【编辑】按钮,开启【增强型Token认证】开关
- 设置认证密钥(建议使用复杂密码,包含大小写字母、数字和特殊字符)
- 点击【保存】,立即记录并安全存档该密钥(此为唯一查看机会)
- 如需重置,可在应用编辑页面找到【重置密钥】功能
—
四、代理用户用户名
定义:用于第三方系统访问的代理用户账号,需具备相应的数据访问权限。
获取步骤:
- 在【第三方系统登录授权】的应用详情页面,开启【启用代理用户控制】开关
- 在【代理用户】输入框中,选择或输入已存在的金蝶云星空用户账号
- 确保该用户已被授予所需业务模块的访问权限(建议单独创建集成专用用户)
- 点击【保存】,该用户名即为代理用户用户名
安全建议:
- 避免使用管理员账号作为代理用户
- 按最小权限原则配置该用户的功能权限和数据权限
—
五、accountId账套ID(数据中心ID)
定义:金蝶云星空系统中账套(数据中心)的唯一标识,用于区分不同的业务数据环境。
获取方式(三种可选):
| 方式 | 适用场景 | 操作步骤 |
| MC管理中心 | 管理员权限 | 1. 登录金蝶云星空管理中心(MC)<br>2. 切换到目标租户<br>3. 进入租户详细页面,查看并复制账套ID |
| API接口 | 开发人员 | 1. 访问系统首页getconfig.do接口<br>2. 切换到Preview模式<br>3. 查找并提取accountId字段值 |
| 应用凭证 | 已创建应用 | 在【第三方系统登录授权】的应用详情页面,认证凭证区域直接获取accountId |
—
六、语言(默认zh_CN)
定义:系统交互语言,默认使用中文简体(zh_CN),支持其他语言(如en_US英文)。
设置方式:
- 通常在连接器配置中直接选择或输入语言代码
- 金蝶云星空旗舰版支持的语言包括:zh_CN(中文简体)、zh_TW(中文繁体)、en_US(英文)等
- 如无特殊需求,保持默认值zh_CN即可
—
七、x-acgw-identity(身份标识)
定义:API请求头中必须携带的公共参数,用于标识请求来源,从产品端内获取。
获取步骤:
- 在【第三方系统登录授权】的应用详情页面,找到【认证凭证】区域
- 直接复制x-acgw-identity值(系统自动生成,与应用和账套绑定)
- 在API请求时,将该值添加到请求头中,格式:
x-acgw-identity: [获取到的值]
重要提示:面向金蝶云星空旗舰版发起的API调用,必须携带此参数,否则请求将被拒绝
—
八、整体操作流程总结
- 准备工作:确保拥有管理员权限,完成OpenAPI初始化
- 创建第三方应用:获取appId和x-acgw-identity
- 配置访问策略:设置AccessToken认证密钥,启用代理用户控制
- 获取账套信息:通过MC或应用凭证获取accountId
- 收集服务器地址和代理用户信息,完成全部参数配置
九、常见问题与注意事项
- 参数保存:所有参数(特别是认证密钥)需妥善保存,建议使用密码管理器存储
- 权限问题:确保管理员账号拥有【第三方系统登录授权】功能的访问权限
- API调用:参数配置完成后,建议先通过API测试工具验证连接是否正常
- 安全最佳实践:定期更新认证密钥,限制代理用户权限,监控第三方应用访问日志
- 官方文档:具体细节请以金蝶云星空旗舰版官方文档和帮助中心说明为准