抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 营销能力
  • 支付
  • 分享
  • 小程序跳转
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • 订阅消息
  • 电商插件能力(即将废弃)
  • 流量来源识别
  • 隐私信息授权
  • web化
  • 转发和挂载
  • 侧边栏能力
  • 直播能力
  • AI/AR能力
  • 安全能力
  • 小程序加密网络通道
  • 行业开放
  • 第三方平台
  • 其它
  • 生活服务(即将废弃)
  • 小程序加密网络通道

    收藏
    我的收藏

    基础库 3.56.0 开始支持本方法,这是一个异步方法。

    获取最新的用户加密密钥

    前提条件
    需要使用 tt.login 进行登陆
    业务背景
    为了避免小程序与开发者后台通信时数据被截取和篡改,开放平台侧维护了一个用户维度的可靠key,用于小程序和后台通信时进行加密和签名。
    使用限制
    注意事项
    支持沙盒
    相关教程

    语法

    tt.getLatestUserCryptoKey(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    successfunction
    接口调用成功的回调函数
    3.56.0
    failfunction
    接口调用失败的回调函数
    3.56.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    3.56.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "getLatestUserCryptoKey:ok"
    3.56.0
    versionnumber
    密钥版本
    3.56.0
    ivstring
    密钥初始向量
    3.56.0
    encryptKeystring
    用户加密密钥
    3.56.0
    expireTimenumber
    密钥过期时间,每个key的存活时间为3600s
    3.56.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "getLatestUserCryptoKey:fail" + 详细错误信息
    3.56.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    175801getLastUserCryptoKey:fail not loginD

    用户未登录,请登陆后再调用这个接口。

    3.56.0
    175802getLastUserCryptoKey:fail request failF
    小程序框架内部错误,有需要请创建工单咨询
    3.56.0
    175803getLastUserCryptoKey:fail server error(err_no)F
    小程序框架内部错误,有需要请创建工单咨询
    3.56.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    // 前端调用示例 const dataInfo = 'testShowValue'; tt.getLatestUserCryptoKey({ success: function (cryptoInfo) { const { encryptKey, iv } = cryptoInfo; const encryptedData = someEncryptMethod(encryptKey, iv, dataInfo); tt.request({ data: encryptedData, success: function (res) { const decryptedData = someDEcryptMethod(encryptKey, iv, res.data) console.log(decryptedData) } }) }, fail: function (e) { console.log('getLatestUserCryptoKey error:', e); }, complete: function () { console.log('getLatestUserCryptoKey complete:', e); } });