文档中心

财经热点洞察

最近更新时间：2023.03.24 15:33:02

首次发布时间：2023.03.24 15:33:02

准备工作

请完成火山引擎账号注册。
如果您首次登录火山引擎控制台，请先完成实名认证。
访问火山引擎内容定制控制台，请先提交试用申请，并等待审核通过。

接入流程

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)