You need to enable JavaScript to run this app.
导航
财经热点洞察
最近更新时间:2023.03.24 15:33:02首次发布时间:2023.03.24 15:33:02
准备工作
  1. 请完成火山引擎账号注册
  2. 如果您首次登录火山引擎控制台,请先完成实名认证
  3. 访问火山引擎内容定制控制台,请先提交试用申请,并等待审核通过。
接入流程

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,火山侧主动调用获取,并请求服务端接口。
    alt
  • 实现办法:由客户侧客户端提供NativeJSBridge接口,给火山侧H5获取鉴权信息
  • 接口定义:window.nativeBridge.getAuthInfo(callbackApi),返回鉴权参数
// 示例
window.nativeBridge.getAuthInfo(
  ({signature, timestamp, nonce, access_token})=>{
    //H5获取signature, timestamp, nonce, access_token并进行处理
  }
)
  • 鉴权参数
分组参数描述类型是否必填说明
鉴权参数signature签名String参见“签名机制
timestamp10位时间戳,单位:秒Long为保证安全,timestamp 与当前时间戳相关绝对值不能超过3600 秒
nonce随机数String6-12位随机字符串
access_token用户身份标识Stringwap注册接口返回的用户唯一标识

注意

  • 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)