基于合宙开放接口开发微信原生小程序
一、整体说明
- 我们提供了一套基于合宙账号认证及合宙开放API进行微信原生开发的代码框架,方便用户快速开发。 本文重点介绍使用流程,对微信小程序的注册及发布等只做简要说明。
- 适合对象: 使用微信原生开发者。个人认证和企业认证的账号都支持。 开发者可以没有自己的服务器/API/域名(具备条件也可以)。
二、准备微信小程序及下载代码
- 前往微信公众平台https://mp.weixin.qq.com/,注册小程序(个人或企业认证)。 企业认证需每年认证费300元,可使用微信原生/Uniapp或H5开发; 个人认证不能使用H5(WebView组件),只能使用微信原生/Uniapp开发。 本文提供的认证框架代码,使用微信原生开发。比较适合个人认证的微信小程序。
- 获取微信小程序的 AppID 和 Secret。
- 配置微信小程序的 request 合法域名。 在微信小程序后台管理中,依次进入:开发与服务 → 开发管理 → 开发设置 → 服务器域名 点击修改:修改request合法域名,并输入https://api-iot.luatos.com;https://iot.openluat.com 请同时配置这两个域名,该接口分别用于平台api接口和验证码、短信及绑定。
- 登录合宙Iot,https://iot.luatos.com,菜单路径:基础能力 > 自建应用 > 自建微信小程序 > 微信原生开发 提交AppID和Secret信息,下载源码
- 点击“提交信息并下载微信小程序代码”后,将下载到一份带合宙账号认证的源码,您可直接基于此源码开发。 基本原理: 登录时,基于您提供的微信小程序AppID和Secret,获取登录用户在合宙的账号并绑定。 首次登录需要绑定手机号,后续可自动登录。全程无需用户密码。
注意事项:信息在提交后,代码只能下载一次,不能重复下载;请慎重重置微信小程序的 Secret,如果您在微信小程序平台重置Secret后,之前创建的应用会因旧 Secret 失效而出现用户无法正常登录;一旦发生重置Secret,会影响已正式发布的线上版本(可以再次发布解决,但微信官方审核发布完成前都会受影响)。
三、开发/发布自己的微信小程序
- 下载开发资源包:https://docs.openluat.com/protocols/aircloud_api/aircloud_api/
- 使用AI工具,将整个工程代码和资源包中的《AirCloud接口文档.md》提供给AI工具,通过AI工具实现业务功能
- 预览等需要微信开发者工具 开发者工具下载地址:https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
- 后续上线发布
注意事项:不要将整个资源包提供给AI工具(部分资源是网页开发使用,原生开发不需要,提供了会让AI误读);示例代码中封装了API鉴权逻辑,AI会自动使用;如果您将本代码作为参考而有自己的项目,需要将api调用相关逻辑(主要是认证及鉴权相关的逻辑)让AI提取出来放入您的项目中。