微信小程序提供了丰富的 API，覆盖用户交互、数据处理、设备控制等多个场景。以下是常用 API 及其典型应用场景的详细说明：
一、用户信息与授权
1.wx.getUserProfile
场景：获取用户头像、昵称等基础信息（需用户主动授权）。
使用：在用户注册或完善资料时调用，替代旧版wx.getUserInfo，需通过按钮点击触发授权流程。
示例：
javascript
复制代码
wx.getUserProfile({
desc: '用于完善会员资料',
success(res) { /* 处理用户信息 */ }
});
2. wx.login
场景：获取临时登录凭证（code），用于后端换取 OpenID。
使用：小程序码登录、手机号绑定等需身份验证的场景。
流程：前端调用wx.login获取 code，后端通过 AppID 和 AppSecret 换取用户唯一标识。
二、界面与交互
1.wx.navigateTo
场景：保留当前页面，跳转到新页面（如商品详情页）。
示例：
javascript
复制代码
wx.navigateTo({ url: '/pages/detail/detail' });
2.wx.showModal
场景：弹出模态对话框，用于操作确认（如删除、退出登录）。
示例：
javascript
复制代码
wx.showModal({
title: '提示',
content: '确定要删除吗？',
success(res) { if (res.confirm) { /* 执行删除 */ } }
});
3.wx.setNavigationBarTitle
场景：动态修改页面导航栏标题（如搜索结果页显示关键词）。
三、网络与数据交互
1.wx.request
场景：发送 HTTP 请求获取或提交数据（如加载商品列表、提交订单）。
示例：
javascript
复制代码
wx.request({
url: 'https://api.example.com/data',
method: 'GET',
success(res) { /* 处理返回数据 */ }
});
2.wx.uploadFile
场景：上传文件（如图像、文档）至服务器（如用户头像上传）。
示例：
javascript
复制代码
wx.chooseImage({
count: 1,
success(res) {
wx.uploadFile({
url: 'https://api.example.com/upload',
filePath: res.tempFilePaths[0],
name: 'file'
});
}
});
四、数据存储
1.wx.setStorageSync
场景：同步存储数据到本地（如用户设置、临时缓存）。
示例：
javascript
复制代码
wx.setStorageSync('token', 'xxx');
2.云开发数据库 API
场景：云端存储结构化数据（如用户订单、商品信息）。
示例：
javascript
复制代码
const db = wx.cloud.database();
db.collection('orders').add({ data: { /* 订单数据 */ } });
TypeScript取消自动换行复制
const db = wx.cloud.database();
db.collection('orders').add({ data: { /* 订单数据 */ } });
五、支付与交易
1.wx.requestPayment
场景：发起微信支付（如电商下单、在线课程购买）。
流程：前端调用云函数生成预支付订单，后端通过微信支付接口获取支付凭证，最后调用wx.requestPayment唤起支付界面。
注意：需配置商户号、API 密钥，并处理支付结果通知。
2.云开发支付模板
场景：通过云开发快速集成支付功能，包括下单、退款查询等，减少服务器运维成本。
六、地理位置与设备
1.wx.getLocation
场景：获取用户位置（如附近商家推荐、地图导航）。
示例：
javascript
复制代码
wx.getLocation({
type: 'wgs84',
success(res) { /* 获取经纬度 */ }
});
2.wx.getSystemInfo
场景：获取设备信息（如屏幕尺寸、操作系统），用于界面适配。
示例：
javascript
复制代码
wx.getSystemInfo({
success(res) { console.log(res.model); } // 输出设备型号
});
七、多媒体与分享
1.wx.chooseImage
场景：选择本地图片或拍照（如社交动态发布、商品图片上传）。
示例：
javascript
复制代码
wx.chooseImage({
count: 3, // 最多选3张
success(res) { /* 处理图片路径 */ }
});
2.wx.shareAppMessage
场景：自定义分享内容到微信好友或朋友圈（如文章、活动页）。
示例：
javascript
复制代码
Page({
onShareAppMessage() {
return { title: '推荐好物', path: '/pages/goods/goods?id=1' };
}
});
八、事件监听与系统管理
1.wx.onAppShow
场景：监听小程序从后台切回前台的事件（如更新未读消息数）。
使用：在 App.js 中注册全局监听。
2.wx.getUpdateManager
场景：检查并处理小程序版本更新（如强制用户升级以使用新功能）。
示例：
javascript
复制代码
const manager = wx.getUpdateManager();
manager.onUpdateReady(() => {
wx.showModal({ content: '新版本已下载，重启生效', success: () => manager.applyUpdate() });
});
九、模板消息与通知
1.模板消息 API
场景：发送订单通知、服务提醒（如支付成功、物流状态更新）。
限制：需通过支付或表单提交获取 formId，且仅在 7 天内有效。
合规建议：优先通过支付场景获取 formId，避免滥用导致封禁。
十、云开发与 AI 能力
1.云开发 AI 接口
场景：调用大模型生成文本、智能客服等（如商品描述生成、用户问题自动回答）。
示例：
javascript
复制代码
const ai = wx.cloud.extend().AI;
const model = ai.createModel('hunyuan-exp');
model.generateText({ messages: [{ role: 'user', content: '介绍一款手机' }] });
2.云数据库操作
场景：云端数据增删改查（如用户评论管理、活动报名统计）。
示例：
javascript
复制代码
db.collection('comments').where({ userId: '123' }).get();