- 请完成火山引擎账号注册。
- 如果您首次登录火山引擎控制台，请先完成实名认证。
- 访问火山引擎内容定制控制台，请先提交试用申请，并等待审核通过。
1. 创建应用
登录火山引擎内容定制控制台 - 应用管理-新建应用
2. 应用接入
2.1 wap注册
客户侧服务端研发需首先参考火山引擎内容定制wap注册文档，生成用户唯一标识，该标识将用于火山引擎侧的推荐系统，进行个性化推荐。
注意
注册返回的 access_token 有效期为60天，access_token 过期后需要重新发起注册请求。
2.2 拼接链接
客户侧客户端研发热点洞察链接后面拼接如下参数，并通过webview等方式将链接嵌入到自有的业务入口中。
| 分组 | 参数 | 描述 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|---|
| 应用参数 | partner | 渠道号 | String | 是 | 登录火山引擎内容定制控制台-应用管理-查看详情，查找对应“渠道号”。 |
https://open.toutiao.com/insight/mobile?partner=xxx (partner替换为客户应用的渠道号）
2.3 生成鉴权字段
因安全要求，鉴权相关参数需要通过 JSBridge 通讯传递。且需要保证鉴权信息失效时，能及时更新。
- 签名逻辑：客户侧生成签名字段的逻辑，可参考文档中 签名机制 。
- 接入流程：客户侧提供获取鉴权参数的nativeBridge，火山侧主动调用获取，并请求服务端接口。
- 实现办法：由客户侧客户端提供NativeJSBridge接口，给火山侧H5获取鉴权信息
- 接口定义：window.nativeBridge.getAuthInfo(callbackApi)，返回鉴权参数
// 示例 window.nativeBridge.getAuthInfo( ({signature, timestamp, nonce, access_token})=>{ //H5获取signature, timestamp, nonce, access_token并进行处理 } )
- 鉴权参数
| 分组 | 参数 | 描述 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|---|
| 鉴权参数 | signature | 签名 | String | 是 | 参见“签名机制” |
| timestamp | 10位时间戳，单位：秒 | Long | 是 | 为保证安全，timestamp 与当前时间戳相关绝对值不能超过3600 秒 | |
| nonce | 随机数 | String | 是 | 6-12位随机字符串 | |
| access_token | 用户身份标识 | String | 是 | wap注册接口返回的用户唯一标识 |
注意
callbackApi 指定了H5端预先注册的回调处理函数，客户端可直接通过 evaluateJavaScript方式，拼接鉴权参数来触发回调处理函数。
鉴权信息signature，timestamp有效期为24小时，如果用户长时间停留页面，会存在签名失效，H5页面无法拉取到内容。
H5前端通过JSBridge获取accessToken等信息，失效后重新调用JSBridge，获取更新后的信息。
分享功能
实现办法：由客户侧客户端提供NativeJSBridge接口，火山侧将分享的标题 / 描述 / 图片等传给客户端，客户端调起第三方应用的分享界面 。
调用示例：window.nativeBridge.share({ title: 'xxx', description: '', image: '' })
基金、股票详情跳转
实现办法：由客户侧客户端提供NativeJSBridge接口，火山侧将代码 / 市场编号等传给客户端，客户端做对应详情页面的跳转。
调用示例：window.nativeBridge.goToStockInfo: (stockCode, market)
设置头部标题
客户端没有header，则无需接入。
实现办法：由客户侧客户端提供NativeJSBridge接口，火山侧将设置的标题 / 颜色等传给客户端，客户端更改header样式。
调用示例：window.nativeBridge.setWebviewTitle: (title, bgColor)
后退监听
有需要监听客户端的后退场景时做接入。
实现办法：由客户侧客户端提供NativeJSBridge接口，火山侧将是否监听 / 监听回调函数等传给客户端，客户端拦截执行后退逻辑。
调用示例：window.nativeBridge.setGoBackListener: (isListener, callback)