Step 1: 成为开发者
注册开发者账号:遵循开发者协议,注册账号(注册的账号是金蝶云账号)
开发商认证:首次登录控制台需要认证开发商,请按步骤完成开发商认证(也可以新建或切换开发商进行认证)
创建应用并获取应用 client_id 和 client_secret:开发商认证后,登录进入API市场控制台在“我的应用”内新建应用并获应用的 client_id 和 client_secret
订阅服务:在已创建的应用列表行进入“订阅服务”,搜索“金蝶KIS云”,点击立即订阅,在已订阅服务栏内就会看到“金蝶KIS云”服务,点击进入服务可以查看已发布的接口和服务文档
详情参考《金蝶KIS云生态伙伴注册认证流程》,完成以上注册、认证、创建应用、订阅服务等步骤
Step 2: 获取access_token
客户登录KIS云开放平台
通过OAuth2.0授权登录KIS云,获取KIS云用户 access_token、session_id(用户会话ID)、session_secret(签名认证密钥),详情 【点击打开接口说明】 查看
通过用户手机短信验证码登录KIS云,获取KIS云用户 access_token、session_id(用户会话ID)、session_secret(签名认证密钥),详情 【点击打开接口说明】 查看
通过“云之家认证授权”接口获取用户access_token 【点击打开获取用户access_token的接口说明】 和授权码 【点击打开获取auth_code的接口说明】 ( 即:auth_code ,调用云之家认证授权接口需要订阅“云之家授权认证”服务 ),再通过auth_code登录KIS云 【点击打开auth_code登录KIS云的接口说明】,获取KIS云用户access_token、session_id、session_secret
提醒:
1)、KIS云用户access_token也是金蝶云平台用户access_token
2)、session_secret 作用是生成 headers签名参数(KIS-Signature)的密钥,若请求接口时提交了 headers的KIS-Signature参数进行签名认证,将忽略 session_id 的过期校验(详情请查看相关接口headers参数KIS-Signature的使用说明)。
Step 3: 获取用户账套列表:通过KIS云用户 access_token、session_id、session_secret获取当前登录用户已授权访问的账套信息
- 登录KIS云开放平台获取的用户 access_token、session_id、session_secret
- 调用获取账套列表接口,详情【点击打开接口说明】 查看
Step 4: 获取生态应用列表:通过用户 access_token、session_id、session_secret 获取开发者有权限访问的生态应用列表
- 登录KIS云开放平台获取的用户 access_token、session_id、session_secret
- 调用获取应用列表接口,详情【点击打开接口说明】 查看
- KIS云生态应用包括KIS云开放的公共应用和开发者上架的私有应用
Step 5: 获取业务接口网关和鉴权数据(auth_data)
- 登录KIS云开放平台获取的用户access_token、session_id、session_secret
- 选择访问的产品(pid)和账套信息(acctnumber)以及应用信息(icrmid)
- 调用获取业务接口网关和auth_data接口,详情 【点击打开接口说明】查看
Step 6: 添加KIS云生态应用
- 第三方应用集成KIS云业务前必须要先添加KIS云生态应用(KIS云开放的公共应用和开发者上架的私有应用),否则无权访问KIS云产品的业务接口
- KIS云公有云添加KIS云生态应用的方法,详情请参考《添加KIS云生态应用流程》
- KIS云私有云添加KIS云生态应用的方法,必须在系统管理-加密管理中开通KIS云生态集成服务(限免)
Step 7: 通过业务接口网关请求KIS云相关产品的业务接口
- 业务接口网关和鉴权数据(auth_data)是 “第五步” 接口获取的,鉴权数据(auth_data)是有效期的,若鉴权数据失效,可以通过提交headers参数KIS-Signature签名校验(签名密钥就是每次登录返回的 session_secret)重复调用 “第五步” 接口获取新的鉴权数据(auth_data) ,同时会忽悠session_id 的过期校验(详情请查看相关接口headers参数KIS-Signature的使用说明)。以便满足一些后台第三方应用无需客户经常登录授权的需求
将对应内容填入轻易云连接器信息,其中:
主机地址:https://api.kingdee.com
应用id:获取到的应用 client_id
应用密钥:获取到的应用client_secret
用户名(手机号):填写对应的手机号
手机验证码:不用填写
用户session_id:填入Step 2获取的session_id
用户token:填入Step 2获取的access_token
产品实例:填入Step 5获取到的pid
账套号:填入Step 3获取到的账套(acctnumber)
应用编号:填入Step 4获取到的用于对接的icrmid
网关后端地址以及auth_data的刷新token:通过小微生态门户-文档详情 (jdy.com)获取