uni-app中调用垃圾分类API需用uni.request发GET请求,传appkey和keyword,域名须配置合法域名,真机调试失败多因域名或HTTPS问题;本地JSON仅适用于极简离线场景。

uni-app 里怎么调用垃圾分类 API 获取数据
直接调用第三方垃圾分类接口是最快落地的方式,比如「垃圾分类查询」常用的是 https://api.binstd.com/waste/query(binstd 提供的免费接口)或「住建部开放平台」的认证接口。uni-app 本身不自带分类逻辑,必须依赖后端服务或轻量级本地规则库。
实操建议:
- 优先用
uni.request发 GET 请求,不要用fetch或 axios(部分小程序平台不支持) - 请求需带上
appkey(注册 binstd 后获取),否则返回{"status":401,"msg":"appkey无效"} - 注意域名要加到
manifest.json → 微信小程序 → request 合法域名中,否则真机调试必报错request:fail net::ERR_FAILED - 示例代码片段:
uni.request({ url: 'https://api.binstd.com/waste/query', data: { key: 'YOUR_APPKEY', keyword: '香蕉皮' }, success: res => { if (res.data.status === 0) { console.log('结果:', res.data.result.classname) // 如“厨余垃圾” } } })
如何在 uni-app 页面里做搜索+结果展示的交互
用户输入关键词、点击搜索、显示分类结果和图标——这个流程不能靠纯静态页面实现,得用响应式数据驱动。
实操建议:
- 用
data定义searchKeyword和result,绑定到和 - 搜索按钮加
disabled状态(通过isSearching控制),避免连点触发多次请求 - 结果页建议按「类别 + 示例物品 + 处理提示」三段式展示,例如:
厨余垃圾→剩饭、菜叶、蛋壳→沥干水分后投放至绿色桶 - 不同分类配不同 icon:可用 uni-icons 插件,或直接用字体图标 class(如
class="icon-lajifenlei-chuyu"),别硬塞图片路径导致包体积膨胀
为什么真机调试时搜不到结果,但开发者工具里正常
90% 是域名或 HTTPS 问题,不是代码逻辑错误。
常见错误现象:
- 开发者工具能查,手机微信打开空白或一直 loading → 没配合法域名或没开「不校验合法域名」(仅开发用,上线必须关)
- 返回
{"status":500,"msg":"参数错误"}→keyword为空或含空格未 trim,uni.trim(this.searchKeyword)要写上 - 中文关键词乱码 → URL 编码没做,改用
encodeURIComponent(keyword)包裹后再拼接 - 安卓手机返回
net::ERR_CLEARTEXT_NOT_PERMITTED→ 后端接口用了 HTTP 协议,必须换 HTTPS,微信小程序强制要求
要不要把分类规则做成本地 JSON 避免调 API
可以,但只适合极简 MVP 场景,且必须接受「覆盖不全 + 维护成本高」。
使用场景:
- 离线可用需求强(比如社区内部小程序,只查 20 种常见垃圾)
- 日均调用量超免费额度,又不想对接鉴权后端
实操建议:
- JSON 文件放
static/data/waste-rules.json,用uni.loadFile或直接 import(需放在common/下并设为编译排除) - 注意大小限制:微信小程序单包 ≤ 2MB,本地规则别超过 300 条,否则影响首屏加载
- 搜索用
Array.find()做模糊匹配(如item.name.includes(keyword)),别用正则增加复杂度 - 无法处理多义词(如“粽叶”在某些城市算其他垃圾,有些算干垃圾),线上 API 才能动态更新规则
实际开发中最容易被忽略的是「用户搜“电池”返回“有害垃圾”,但搜“充电宝”却没结果」——这类长尾词得靠接口兜底,本地规则很难穷举。上线前务必用真实用户常搜的 50 个词跑一遍测试。











