位置: IT常识 - 正文

抖音小程序实践三:接口开发指南(抖音小程序任务哪里接)

编辑:rootadmin
抖音小程序实践三:接口开发指南

推荐整理分享抖音小程序实践三:接口开发指南(抖音小程序任务哪里接),希望有所帮助,仅作参考,欢迎阅读内容。

文章相关热门搜索词:抖音小程序设计规范,小程序实践报告,微信小程序实践总结,抖音小程序项目怎么样,抖音小程序运营方案,抖音小程序运营方案,小程序实践报告,小程序实践报告,内容如对您有帮助,希望把文章链接给更多的朋友!

通过官方文档可以更系统的学习到所有的接口,我这边罗列一下我自己用到测试过的接口供大家参考。

前端-小程序对接官方文档:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/user-information/tt-get-user-info服务端-小程序官方文档:https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/server/server-api-introduction

1.前端-获取用户信息授权

API文档:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/user-information/tt-get-user-info

// tt.getUserProfile(); 获取用户的基本信息,只可在 tap和支付 事件回调中调用,每次调用都会弹出授权提示窗,若用户同意,则会返回用户的真实数据。 //获取已登录用户的基本信息或特殊信息,首次使用的用户会弹出授权提示窗,若用户同意,则会返回用户的真实数据。 tt.getUserInfo({ success(res) { console.log("getUserInfo 调用成功", JSON.stringify(res)); }, fail(res) { console.log("getUserInfo 调用失败", JSON.stringify(res)); }, })

响应:

{ "userInfo": { "nickName": "claxxxxxhen", "avatarUrl": "https://p9-passport.byteacctimg.com/img/mosaic-legacy/3796/2975xxx00.image", "gender": 0, "city": "", "province": "", "country": "", "language": "", "userId": "37431xxxxx1486", "sessionId": "3b652xxxxxxc3b490351ef1311" }, "rawData": "{\"nickName\":\"claixxxxn\",\"avatarUrl\":\"https://p9-passport.byteacctimg.com/img/mosaic-legacy/3796/297xxxx.image\",\"gender\":0,\"city\":\"\",\"province\":\"\",\"country\":\"\",\"language\":\"\"}", "signature": "5fed6c636f3cdxxxxx3d2e97e0869d0", "encryptedData": "G+kEtB+JE2S3/r8V0Ftxxxx/CxxxxxxxxxxxxxFKKLp6LNpm3QtoHlj2BZREiN8zSE8z7gK51ECsKFDyPn4mtuthY90zj+Zwx0EPyC+DwP1ZJ4ahVawzVkMdnBMhnT48+7CZvOAWa/LyY93MmSsDNLDR0BBTpBnYbnqSW3tGNvTcllNuX2F1Laso2RtsFQlQPoVvoBysfIxliFDvL2+Rw/ZEIc2i7uXnbDeTzPuiiC8km7a/ImZSEZiTdsGNDKEnepmYStswydENgG51NiPRwj15JyOAeALb34xhgYFFZGZFw703XGUbXIn8s8tbqJ+u72cjbqxTp/D7qBL2cHA3uJC6rhrM/VgH7hiDMlwApdRQuFcNQSItQ41RhcD14R7iFoQObc4/IPT0BmvG+WuKMV+PuEp8vaA==", "iv": "ar8P0OkTQxxxxqHrW9w==", "errMsg": "getUserProfile:ok"}其中encryptedData是需要的用户openId等数据iv是用于解密的,需要留存

Q:此外,什么是用户的openId?什么是用户的unionId? A:开发者可通过OpenID来获取用户基本信息。特别需要注意的是,如果开发者拥有多个移动应用、网站应用和公众帐号,可通过获取用户基本信息中的unionid来区分用户的唯一性。也就是说,小程序内openId是唯一的,全平台unionId是唯一的。

2.前端-用户登录

API文档:https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/api/open-interface/log-in/tt-login

tt.login({ force: true, success(res) { console.log(`login 调用成功${res.code}${res.anonymousCode}`); }, fail(res) { console.log(`login 调用失败`); },});

响应:

{ "anonymousCode": "UAx9YfgVDsxxxxxxxxxxiZCXh7OaAfiW8ei…6mhQP1ETXRfFRKxidnPqMxZtxgXv7yrbWjkBwVePN6FIJq-1Q", "code": "1ujmWYVW0mlU4xzzzzzzxxxxxxxxMUkdf9Vp1…g9z0Gy8LFbNekfVjY-Ng6V4_Bc6HxAPQ-SQvrPS8Gf-1ZFvaE", "isLogin": true, "errMsg": "login:ok"}

tt.login调用douyin接口登录,获取code/anonymous_code,这两个字段是后续个人加密信息解密的重要字段

3.服务端-jscode2session换取sessionKey

API文档:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/server/log-in/code-2-session/

Map<String, String> dataMap = new HashMap<>(); dataMap.put("appid", "tt60d416xxxxc8801"); dataMap.put("secret", "582830exxxxc99e14c0999a"); dataMap.put("code", "3muFdjQoIFZw0WcBLhltspBxxxxxNfT6mkCQO4RbKicdR0j7a12-PRO6yRCHn90HYDg8DerKt_lxoVr1Donbw"); dataMap.put("anonymous_code", "i8MsKM6tGuKzjxMH3vJF3R4NxAN6xxxxxxxx38wsHAcfmY4dXwaWInvy6isFJ5X8ejQzKcYJVgiPCPkBkMwkw4MrRjFY_iVDOcTOY74"); HttpResult httpResult = HttpClientUtils.doPostJson("https://developer.toutiao.com/api/apps/v2/jscode2session", JSON.toJSONString(dataMap));//注意这是生产的地址 String res = httpResult.getBody(); System.out.println(res);

响应:

{ "err_no": 0, "err_tips": "success", "data": { "session_key": "hZy6t19VPjFqm********", "openid": "V3WvSshYq9******", "anonymous_openid": "", "unionid": "f7510d9ab***********" }}这个时候能够获取session_key(解密用户信息的重点字段),此外还有重要的用户openid和unionid4.服务端-敏感信息解密

API文档:https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/user-information/sensitive-data-process/ 这边测试解密用户信息,此外手机号等encryptData的数据,都可以拿这套流程来解密。 我这边主要写了java后端解密的方法,对于js也可以解密,官方文档有比较多的方法展示。

Base64.Decoder decoder = Base64.getDecoder(); byte[] sessionKeyBytes = decoder.decode("Ps2xsxxxxxxxJkA=="); byte[] ivBytes = decoder.decode("ar8P0OxxxxxxqHrW9w=="); byte[] encryptedBytes = decoder.decode("cfOy32OwcBaZv7xxxxxxxxxxxvZQHOjzDABhBOWInm0PNGwzXIBkUIZmto2pjC8VDmZS3v3N27OCb2c5E7DblfSVbcjXHuZN7OPB+zOxDADD7Q=="); Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding"); SecretKeySpec skeySpec = new SecretKeySpec(sessionKeyBytes, "AES"); IvParameterSpec ivSpec = new IvParameterSpec(ivBytes); cipher.init(Cipher.DECRYPT_MODE, skeySpec, ivSpec); byte[] ret = cipher.doFinal(encryptedBytes); String res = new String(ret); System.out.println(res);注意:Cipher cipher = Cipher.getInstance(“AES/CBC/PKCS5Padding”); // JDK does not support PKCS7Padding, use PKCS5Padding instead以上会有一个坑,对于JDK版本的不同,对解密的key的长度会有限制。比如Illegal key size or default parameters这种错误。因为美国的出口限制,Sun通过权限文件(local_policy.jar、US_export_policy.jar)做了相应限制。因此存在一些问题:●密钥长度上不能满足需求(如:java.security.InvalidKeyException: Illegal key size or default parameters),然后网上说要通过替换JDK/jre/lib/security的local_policy.jar我们正好遇到了服务器上的JDK版本较老,本地的JDK比较新,而上线报错这样的问题,下面的方法亲测解决异常关于JDK如何启用无限强度加密:针对Java 8u151之前版本,内含有限强度策略文件,我们下载 oracle上的无限制版本替换local_policy.jar、US_export_policy.jar针对Java 8u151之后版本,默认采用无限强度策略文件,如果我们想定义要使用的版本,有一个安全属性crypto.policy。Security.setProperty(“crypto.policy”,“unlimited”).在JCE框架初始化之前设置该属性。5.再看看敏感数据解密流程tt.login调用douyin接口登录,获取code/anonymous_codegetUserProfile,获取iv、encryptedDatajscode2session 获取session_key (前后端获取均可)解密用户信息 (前后端解密均可),注意保存用户信息

这样就能够获取openid\unionid\用户明文信息了

6.前端-获取用户设备信息tt.getSystemInfo({ success(res) { console.log("getSystemInfo 调用成功", JSON.stringify(res)); }, fail(res) { console.log("getSystemInfo 调用失败", JSON.stringify(res)); }, });抖音小程序实践三:接口开发指南(抖音小程序任务哪里接)

响应:

"language": "zh_CN", "version": "6.6.3", "brand": "devtools", "fontSizeSetting": 16, "platform": "devtools", "battery": 100, "wifiSignal": 4, "appName": "devtools", "statusBarHeight": 47, "nativeSDKVersion": "10.3.0", "model": "iPhone 12", "system": "iOS 14", "deviceScore": { "cpu": 7.905, "gpu": 9.0622, "memory": 7.0344, "overall": 7.9524 }, "SDKVersion": "2.68.0", "pixelRatio": 3, "screenWidth": 390, "screenHeight": 844, "windowWidth": 390, "windowHeight": 844, "safeArea": { "left": 0, "right": 390, "top": 47, "bottom": 810, "width": 390, "height": 763 }, "SDKUpdateVersion": "2.68.0.3", "devicePixelRatio": 3, "errMsg": "getSystemInfo:ok"}7.前端-获取用户手机号

获取抖音API当前登录状态的手机号,获取前需用户授权,否则无法获取。注意:该能力无法直接使用,需申请白名单

小程序获取手机号授权能力仅适用于以下场景:网络购物、帐号下信息内容同步、票务预订、业务办理、信息查询(如:社保、公积金)、预约等,其他不符合使用规范的申请不予开通,申请可参考: 获取用户手机号开通指南

评级达 B 级,且信用分达到 90 分的企业主体小程序,可以申请获取用户手机号能力

tt.getPhoneNumber({ success(res) { console.log("getPhoneNumber 调用成功", JSON.stringify(res)); }, fail(res) { console.log("getPhoneNumber 调用失败", JSON.stringify(res)); }, })

响应:

{ "detail": { "cloudId": "", "encryptedData": "0tJ8EV5kwMq8xxxxxxQmf1KG2yKVJX3pYMgWbnY4SJ0MmWMFHJx1ySIaWIgt09sMCL0vAPmgMQ8Hv6d9NgRksOYDTdO1JEmJMy4VGJpBUKL3qqcOvBIc6ToN3RyUTad6Q==", "iv": "ZtZtYvS7gNbGMpyYg500rA==", "errMsg": "getPhoneNumber:ok" }, "errMsg": "getPhoneNumber:ok"}

这个数据就一样解密即可

8.前端-获取用户精准位置信息

用于频繁请求地理位置,实时获取精确位置信息。一般适用于打车、外卖等需要频繁请求获取地理位置的行业。需要申请后可查看。

tt.chooseAddress({ success(res) { console.log("chooseAddress 调用成功", JSON.stringify(res)); }, fail(res) { console.log("chooseAddress 调用失败", JSON.stringify(res)); }, })

只要有接口权限,并且是用户登录授权状态,即可获取 响应:

{ "longitude": 116.3974, "latitude": 39.9092, "city": "北京市", "speed": 0, "accuracy": 65, "altitude": 0, "verticalAccuracy": 65, "horizontalAccuracy": 65, "errMsg": "getLocation:ok"}9.前端-消息订阅

前端发起用户订阅订单消息通知,用户同意后,即可通过接口发送实时订单消息给用户,提升用户体验

小程序消息订阅能力说明

注意:沙盒内测试仅支持安卓,如绑定的设备是IOS的测试会报错 — {"errMsg":"requestSubscribeMessage:fail not supported by current application","errNo":21502}

tt.requestSubscribeMessage({ tmplIds: [], // 需要填入开放平台申请的模版id,支持最多3个同类型模版 success(res) { //订阅成功 console.log("订阅成功", res); }, fail(error) { //订阅失败 console.log("订阅失败, 错误详情: ", error); tt.showToast({ title: "订阅失败", icon: "fail", }); }, complete(res) { //订阅完成 console.log("tt.requestSubscribeMessage API调用完成: ", res); }, });

如果是安卓设备,请求结果如下:

{ "MSG137673105551c58exxxxx15858": "accept", "itemSettings": { "MSG137673105551cxxxxxbf15858": "accept" }, "errMsg": "requestSubscribeMessage:ok"}10.服务端-获取AccessToken

AccessToken是接口鉴权凭证 access_token 是小程序的全局唯一调用凭据,开发者调用小程序支付时需要使用 access_token。access_token 的有效期为 2 个小时,需要定时刷新 access_token,重复获取会导致之前一次获取的 access_token 的有效期缩短为 5 分钟。

接口:POST https://developer.toutiao.com/api/apps/v2/token 请求示例:

curl --location --request POST 'https://developer.toutiao.com/api/apps/v2/token' \--header 'Content-Type: application/json' \--data-raw '{ "appid": "ttabc*****", "secret": "d428***********", "grant_type": "client_credential"}'

响应:

{ "err_no": 0, "err_tips": "success", "data": { "access_token": "0801121***********", "expires_in": 7200 }}11.服务端-发送订阅消息

请求地址: POST https://developer.toutiao.com/api/apps/subscribe_notification/developer/v1/notify POSTMAN中的请求示例

curl --location --request POST 'https://developer.toutiao.com/api/apps/subscribe_notification/developer/v1/notify' \--header 'Content-Type: application/json' \--data-raw '{ "access_token": "080112184679zzzz7556f426d33673d3d", "app_id": "tt60d4166zzzzzzz8801", "tpl_id": "MSG137673105zzzzzz7c84bf15858", "open_id": "_000S3uzzzzzzzzAzN_zZb", "data": { "快递派送": "SF1111111111" }}'

响应:

{ "err_no": 0, "err_tips": ""}
本文链接地址:https://www.jiuchutong.com/zhishi/287141.html 转载请保留说明!

上一篇:vue中,右键菜单组件v-contextmenu的使用(vue 右键菜单)

下一篇:阿尔塞多火山上的象龟,加拉帕戈斯群岛 (© Tui De Roy/Minden Pictures)(阿尔山火山)

  • 微信怎么艾特群里的一个人(微信怎么艾特群里人)

    微信怎么艾特群里的一个人(微信怎么艾特群里人)

  • 微信在哪修改扫一扫优先支付(微信在哪修改扫一扫优先支付 不是扫的时候才修改)

    微信在哪修改扫一扫优先支付(微信在哪修改扫一扫优先支付 不是扫的时候才修改)

  • keep能投屏到电视吗(keep能否投屏到电视)

    keep能投屏到电视吗(keep能否投屏到电视)

  • 华为手机老年模式怎么调(华为智能手机老年模式)

    华为手机老年模式怎么调(华为智能手机老年模式)

  • 华为手机怎么看手机运行了什么程序(华为手机怎么看电池健康度)

    华为手机怎么看手机运行了什么程序(华为手机怎么看电池健康度)

  • 惠普178nw怎么加碳粉(惠普178nw怎么加纸)

    惠普178nw怎么加碳粉(惠普178nw怎么加纸)

  • 快手物流不更新怎么办(快手物流不更新,店家说跟踪)

    快手物流不更新怎么办(快手物流不更新,店家说跟踪)

  • 投屏搜不到电视设备(投屏搜不到电视机怎么办)

    投屏搜不到电视设备(投屏搜不到电视机怎么办)

  • 美团众包永久封禁还能解封吗(美团众包永久封禁怎么解封)

    美团众包永久封禁还能解封吗(美团众包永久封禁怎么解封)

  • 手机腾讯会议怎么把音量调小(手机腾讯会议怎么上传文档)

    手机腾讯会议怎么把音量调小(手机腾讯会议怎么上传文档)

  • 苹果手机信息有个红色感叹号怎么去掉(苹果手机信息有红色感叹号怎么回事)

    苹果手机信息有个红色感叹号怎么去掉(苹果手机信息有红色感叹号怎么回事)

  • 小米开机卡在unlocked(小米开机卡在mi界面)

    小米开机卡在unlocked(小米开机卡在mi界面)

  • vivo空调遥控器在哪(vivo空调遥控器没有红外)

    vivo空调遥控器在哪(vivo空调遥控器没有红外)

  • cha fan1什么接口(chafan1什么接口)

    cha fan1什么接口(chafan1什么接口)

  • 拨打的电话已关机是什么意思(拨打的电话已关机或者无法接通)

    拨打的电话已关机是什么意思(拨打的电话已关机或者无法接通)

  • 腾讯看点怎么取消(腾讯看点如何彻底关闭2020)

    腾讯看点怎么取消(腾讯看点如何彻底关闭2020)

  • 陌陌注销了还能登上吗(陌陌注销了还能用原手机注册吗)

    陌陌注销了还能登上吗(陌陌注销了还能用原手机注册吗)

  • 怎么让陌生人看不到朋友圈(怎么让陌生人看不到朋友圈背景)

    怎么让陌生人看不到朋友圈(怎么让陌生人看不到朋友圈背景)

  • 手机快手是什么意思(你不知道快手是什么吗)

    手机快手是什么意思(你不知道快手是什么吗)

  • ppt如何保存为ppsx(ppt如何保存为兼容版本)

    ppt如何保存为ppsx(ppt如何保存为兼容版本)

  • 微信怎么更换实名信息(微信怎么更换实名认证后账号会消失吗)

    微信怎么更换实名信息(微信怎么更换实名认证后账号会消失吗)

  • 闲鱼怎么清除所有聊天记录(闲鱼如何清空)

    闲鱼怎么清除所有聊天记录(闲鱼如何清空)

  • 苹果换手机怎么把东西移过去(苹果换手机怎么恢复微信聊天记录的内容)

    苹果换手机怎么把东西移过去(苹果换手机怎么恢复微信聊天记录的内容)

  • 基带坏了是什么症状(基带坏了是什么样子的)

    基带坏了是什么症状(基带坏了是什么样子的)

  • 苹果手机在哪里可以测量距离(苹果手机在哪里看激活时间)

    苹果手机在哪里可以测量距离(苹果手机在哪里看激活时间)

  • iphone如何看是国行(iPhone如何看是国行)

    iphone如何看是国行(iPhone如何看是国行)

  • 探探开通自动续费可以取消吗(探探开通自动续费后在关掉可以吗)

    探探开通自动续费可以取消吗(探探开通自动续费后在关掉可以吗)

  • Linux系统下查看网络接口数据信息的命令总结(linux 操作系统查看)

    Linux系统下查看网络接口数据信息的命令总结(linux 操作系统查看)

  • 建筑业如何分项目核算
  • 分公司可以享受当地优惠吗?
  • 单位历史遗留问题
  • 企业纳税过程
  • 库存现金账务处理
  • 工程材料发票备注要求
  • 发票上的收款人负法律责任吗
  • 累计扣税法什么时候实行的
  • 分公司企业所得税分配比例
  • 财务发票报销时限是多久
  • 红线范围外增加的工程量
  • 以无形资产投资入股缴纳哪些税收
  • 服务业税收包括什么
  • 出纳需要填哪些表
  • 工程成本控制方法
  • 股息和资本利得的区别
  • 小企业所得税申报流程
  • 存货周转天数一般在多少为合适
  • 不用发票可以报销吗
  • 保险公司赔偿计入营业外收入
  • 享受企业所得税税额抵免优惠的设备包括
  • 发放活动奖金支出怎么入账
  • 外包的人力费用包括哪些
  • 赠票视同销售,借方计入什么科目?
  • 已备案购销合同
  • 租房押金收不回来怎么做账
  • 筹建期间的开办费包括哪些
  • 对于接受捐赠的资产价值,应计入当期损益
  • php current
  • php缓存数据到内存
  • 年度一次性计税
  • 珀泽申群岛上的阿德利企鹅,南极洲 (© Tui De Roy/Minden Pictures)
  • 了解的反义词
  • 增值税和所得税重复交了吗
  • vue假数据
  • 帝国cms是基于什么的
  • 其他权益工具投资公允价值变动怎么计算
  • 企业转让应收账款分录
  • 没有银行回单,只有银行对账单,可以入账吗
  • mysql_assoc
  • 财务人员如何做一个合格的党员
  • 需要什么证件和材料
  • 不动产经营租赁发票开具注意
  • 个人独资企业购入设备可以一次性计提吗
  • 文化服务要交文化部门吗
  • 年底要结转净利润怎么算
  • 主营业务收入科目按其所归属的会计要素不同
  • 其他流动资产待摊费用
  • 海关报关单海关签章
  • 单位垫付职工个税如何记账
  • 车船税没有发票可以入账吗
  • 暂估入账错误了怎么办
  • 结转周转材料成本
  • 如何计算税前工资
  • 职工外地就医怎么报销
  • 餐饮业怎样做账
  • windows xp 注册表故障恢复
  • centos virsh
  • centos启动卡在了启动界面
  • win10系统的文件夹选项在哪里
  • linux内核编程指南
  • linux学啥
  • Linux如何清理磁盘空间
  • unity 手册
  • cocos2dx4.0教程
  • 对于javascript理解
  • json对象如何取值
  • bash特殊符号
  • vue gallery
  • jquery 右键菜单
  • jquery插件库怎么导入
  • js函数里的函数怎么调用
  • node.js的内置模块
  • 蛋疼的生活歌曲
  • javascript函数如何定义及其作用
  • 天津国税局电子税务局
  • 新车购置税是多少
  • 拉萨税务局拉巴卓玛
  • 北京买车如何摇号
  • 南宁市税务局稽查局领导
  • 免责声明:网站部分图片文字素材来源于网络,如有侵权,请及时告知,我们会第一时间删除,谢谢! 邮箱:opceo@qq.com

    鄂ICP备2023003026号

    网站地图: 企业信息 工商信息 财税知识 网络常识 编程技术

    友情链接: 武汉网站建设