垃圾分类 API

按物品名查询所属垃圾分类（可回收物（上海叫可回收物）、有害垃圾（上海叫有害垃圾）、厨余垃圾（上海叫湿垃圾）、其他垃圾（上海叫干垃圾）），返回投放指南，支持模糊匹配；词库 330 种常见物品

数据来源：本地词库（按 GB/T 19095-2019 与上海市生活垃圾分类指引整理）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

查询物品属于哪类垃圾及投放要求

GET /api/garbage

请求参数

  • name（必填）：物品名，支持模糊匹配：查“电池”会同时列出干电池、纽扣电池等；查不到返回 404 并在 message 中给出相近物品，示例 电池

返回字段

  • query（string）：查询的物品名（原样返回）
  • exact（boolean）：最佳匹配是否与查询词完全相同；为 false 时是模糊匹配的结果，建议看 matches 确认
  • name（string）：最佳匹配的物品名
  • category（string）：最佳匹配所属分类（国家标准名称）：可回收物 / 有害垃圾 / 厨余垃圾 / 其他垃圾
  • alias（string）：该分类在上海的叫法：可回收物 / 有害垃圾 / 湿垃圾 / 干垃圾
  • color（string）：该分类的标志色（十六进制，如 #1E5AA8）
  • guide（string）：该分类的投放指南
  • note（string|null）：该物品的补充说明（地区差异、特殊投放要求）；没有时为 null
  • ambiguous（boolean）：匹配到的物品是否分属不同分类（如查“电池”：干电池是其他垃圾，纽扣电池是有害垃圾），为 true 时请按具体物品判断
  • matches（array）：全部匹配结果（最多 10 条），完全相同的排最前，其次按名称接近程度排序；第一条即最佳匹配
  • matches[].name（string）：物品名
  • matches[].category（string）：所属分类（国家标准名称）
  • matches[].alias（string）：所属分类在上海的叫法
  • matches[].color（string）：所属分类的标志色
  • matches[].note（string|null）：补充说明；没有时为 null