简体中文
应用接入指南
约 961 字大约 3 分钟
2026-01-16
纷享提供了应用入口,你可以方便地把已有的 H5 / Web 应用添加到纷享销客,具体请参考 企业自建应用介绍。
同时我们提供了身份验证 API,可以使用纷享账号免登陆进入你的应用,也可以使用 JS API 和 UI组件使你的应用有更丰富功能,更轻松地满足企业个性化需求。
如果只是添加应用入口,而不做免登录,也不使用JS API,那么不需要写代码,只需要完成下面第一步即可; 如果你的应用需要做免登陆,请在完成下面第三步以后调用身份验证接口; 如果你的应用需要使用 JS API,请按照下面完整步骤操作。
接入步骤
第一步:创建企业自建应用 第二步:获取CorpAccessToken 第三步:对CorpAccessToken做缓存处理 第四步:获取jsticket 第五步:计算签名 第六步:初始化 JS API 第七步:开发应用逻辑
第一步:创建企业自建应用
管理员登录纷享销客网页端后进入“应用”频道“应用管理”,点击“添加应用”完成应用添加和配置,在配置过程中对应用开启“开发模式”。开启“开发模式”以后可以看到 appId、appSecret 和 permanentCode,请记录下来,第二步需要用到。详细步骤请参考 创建企业自建应用。
如果只添加应用入口而不调用API,不需要对“应用”开启“开发模式”。
第二步:获取CorpAccessToken
通过第一步获取的 appId、appSecret 和permanentCode 换取 CoprAccessToken,详细请参考 建立连接-获取CorpAccessToken。
第三步:对CorpAccessToken做缓存处理
每个 access_token 的有效期为7200秒(2小时),有效期内重复获取返回相同结果,并自动续期。所以为了防止因为频率调用次数超出限制而影响功能正常使用的问题,建议开发者将中间生成的 CorpAccessToken 进行缓存,过期以后再重新获取。同时由于每个应用的 CorpAccessToken 是彼此独立的,所以进行缓存时需要区分应用来进行存储。
如果你的应用需要做免账号登陆,完成第三步以后即可开发应用逻辑调用身份验证接口(具体请参考 身份验证接口)。
第四步:获取JsapiTicket
JsapiTicket 是纷享应用调用纷享JS API的临时票据,在签名计算中使用。正常情况下,JsapiTicket 的有效期为7200秒,通过 corpAccessToken 来获取。详情请参考 建立连接-获取JsapiTicket。 为提高性能,且避免频繁刷新 JsapiTicket 导致 API 调用受限,影响自身业务,开发者必须在自己的服务全局缓存 JsapiTicket。
第五步:计算签名
签名生成规则如下:参与签名的字段包括noncestr(随机字符串), 有效的jsapi_ticket, timestamp(时间戳), url(当前网页的URL,不包含#及其后面部分) 。对所有待签名参数按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串src_string,参数名均为小写字符,字段名和字段值都采用原始值,不进行URL转义。最后对src_string作sha1加密,即signature=sha1(src_string)。
第六步:初始化 JS API
请参考 初始化JS API运行环境。
第七步:开发应用逻辑
Well done, 准备工作已经就绪。请继续阅读 客户端开发文档 了解更多关于纷享提供的 JS API和UI组件库,它们可以为你的应用提供更丰富的功能。
