uniapp接口

uniapp接口开发基础

uniapp提供了丰富的API接口用于跨平台应用开发，涵盖网络请求、数据缓存、设备信息获取等功能。以下为常用接口分类及使用方法：

网络请求 使用uni.request发起HTTP请求，支持Promise风格调用：

uni.request({
  url: 'https://example.com/api',
  method: 'POST',
  data: { key: 'value' },
  success: (res) => console.log(res.data)
})

数据缓存 通过uni.setStorageSync实现本地持久化存储：

uni.setStorageSync('key', 'value')
const data = uni.getStorageSync('key')

跨平台兼容处理

条件编译 使用特殊注释实现不同平台的差异化代码：

// #ifdef H5
console.log('仅在H5平台执行')
// #endif

设备API适配 调用uni.getSystemInfo获取运行时环境信息：

uni.getSystemInfo({
  success: (res) => {
    console.log(res.platform)
  }
})

第三方接口接入

微信小程序支付 集成支付功能需先配置manifest.json：

"mp-weixin": {
  "appid": "wx123456789",
  "payment": {}
}

调用支付API：

uni.requestPayment({
  provider: 'wxpay',
  orderInfo: '订单信息'
})

地图服务 通过uni.chooseLocation调用原生地图：

uni.chooseLocation({
  success: (res) => {
    console.log(res.name)
  }
})

接口安全实践

请求签名 建议对敏感接口增加参数签名：

const sign = md5(apiKey + timestamp + nonce)

HTTPS强制 在manifest.json中配置：

"networkTimeout": {
  "request": 30000,
  "sslVerify": true
}

调试与监控

接口日志 使用uni.addInterceptor拦截请求：

uni.addInterceptor('request', {
  invoke(args) {
    console.log('请求参数:', args)
  }
})

性能分析 通过uni.report上报接口性能数据：

uni.report('API_RESPONSE_TIME', { time: 300ms })

以上接口均需在真机环境中测试完整功能，部分API在不同平台存在实现差异，建议参考uniapp官方文档进行详细参数配置。