篮球协会小程序接口文档


关注公众号

<p>&lt;p&gt;[TOC]&lt;/p&gt; &lt;h5&gt;简要描述&lt;/h5&gt; &lt;ul&gt; &lt;li&gt;通过微信小程序原生 API 引导用户跳转至官方公众号主页,实现一键关注功能。本功能无需后端接口支持,依赖小程序与公众号的关联配置。&lt;/li&gt; &lt;/ul&gt; &lt;h5&gt;请求URL&lt;/h5&gt; &lt;ul&gt; &lt;li&gt;&lt;code&gt;前端调用:wx.openOfficialAccountProfile&lt;/code&gt;&lt;/li&gt; &lt;/ul&gt; &lt;h5&gt;请求方式&lt;/h5&gt; &lt;ul&gt; &lt;li&gt;前端调用(JavaScript)&lt;/li&gt; &lt;/ul&gt; &lt;h5&gt;功能说明&lt;/h5&gt; &lt;ul&gt; &lt;li&gt;调用微信官方 API 打开公众号资料页,用户可直接关注。&lt;/li&gt; &lt;li&gt;无需后端提供数据接口。&lt;/li&gt; &lt;li&gt;需在小程序管理后台完成公众号关联。&lt;/li&gt; &lt;/ul&gt; &lt;h5&gt;前提条件&lt;/h5&gt; &lt;table&gt; &lt;thead&gt; &lt;tr&gt; &lt;th style=&quot;text-align: left;&quot;&gt;条件&lt;/th&gt; &lt;th&gt;说明&lt;/th&gt; &lt;/tr&gt; &lt;/thead&gt; &lt;tbody&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;小程序已上线或体验版&lt;/td&gt; &lt;td&gt;仅上线或体验版支持调用此 API&lt;/td&gt; &lt;/tr&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;公众号已认证&lt;/td&gt; &lt;td&gt;需为服务号或订阅号(已认证)&lt;/td&gt; &lt;/tr&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;小程序与公众号已关联&lt;/td&gt; &lt;td&gt;在小程序后台「设置」→「基本设置」→「公众号关联」中完成绑定&lt;/td&gt; &lt;/tr&gt; &lt;/tbody&gt; &lt;/table&gt; &lt;h5&gt;前端调用代码示例&lt;/h5&gt; &lt;pre&gt;&lt;code&gt;const followOfficialAccount = () =&gt; { wx.openOfficialAccountProfile({ success: function(res) { console.log(&#039;打开公众号资料成功&#039;, res); }, fail: function(err) { console.error(&#039;打开公众号资料失败&#039;, err); uni.showToast({ title: &#039;请搜索【少体官方】关注我们&#039;, icon: &#039;none&#039; }); } }); }; &lt;/code&gt;&lt;/pre&gt; &lt;h5&gt;返回示例(success)&lt;/h5&gt; &lt;pre&gt;&lt;code&gt;{ &quot;errMsg&quot;: &quot;openOfficialAccountProfile:ok&quot; } &lt;/code&gt;&lt;/pre&gt; &lt;h5&gt;返回示例(fail)&lt;/h5&gt; &lt;pre&gt;&lt;code&gt;{ &quot;errMsg&quot;: &quot;openOfficialAccountProfile:fail&quot; } &lt;/code&gt;&lt;/pre&gt; &lt;h5&gt;常见错误码&lt;/h5&gt; &lt;table&gt; &lt;thead&gt; &lt;tr&gt; &lt;th style=&quot;text-align: left;&quot;&gt;错误码&lt;/th&gt; &lt;th&gt;说明&lt;/th&gt; &lt;th&gt;解决方案&lt;/th&gt; &lt;/tr&gt; &lt;/thead&gt; &lt;tbody&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;fail&lt;/td&gt; &lt;td&gt;调用失败&lt;/td&gt; &lt;td&gt;检查小程序是否已关联公众号&lt;/td&gt; &lt;/tr&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;not login&lt;/td&gt; &lt;td&gt;用户未登录&lt;/td&gt; &lt;td&gt;确保用户已授权登录&lt;/td&gt; &lt;/tr&gt; &lt;tr&gt; &lt;td style=&quot;text-align: left;&quot;&gt;permission denied&lt;/td&gt; &lt;td&gt;权限不足&lt;/td&gt; &lt;td&gt;确认公众号类型支持此功能&lt;/td&gt; &lt;/tr&gt; &lt;/tbody&gt; &lt;/table&gt; &lt;h5&gt;注意事项&lt;/h5&gt; &lt;ul&gt; &lt;li&gt;此功能仅在真机运行时生效,开发者工具中可能无法测试。&lt;/li&gt; &lt;li&gt;建议在按钮点击后添加埋点,统计“关注引导”点击次数。&lt;/li&gt; &lt;li&gt;若调用失败,建议提供备用方案:如弹窗提示用户手动搜索公众号名称关注。&lt;/li&gt; &lt;/ul&gt;</p>

页面列表

ITEM_HTML