此接口基于本地数据,提供垃圾分类查询服务。输入垃圾名称,即可获取其所属类别(可回收物、有害垃圾、湿垃圾、干垃圾)及投放要求。支持多请求方式,以 JSON 格式输出,适用于环保类应用,助力本地垃圾分类工作。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| msg | string | 是 | 需要查询投放的垃圾名称,可模糊输入,如:纸屑 | 纸屑 |
[
{
"name": "msg",
"type": "string",
"required": true,
"description": "需要查询投放的垃圾名称,可模糊输入,如:纸屑",
"example": "纸屑"
}
]
{"openapi":"3.1.1","info":{"title":"垃圾分类","description":"此接口基于本地数据,提供垃圾分类查询服务。输入垃圾名称,即可获取其所属类别(可回收物、有害垃圾、湿垃圾、干垃圾)及投放要求。支持多请求方式,以 JSON 格式输出,适用于环保类应用,助力本地垃圾分类工作。","version":"1.0.0"},"paths":{"/v1/zs_ljfl.php":{"get":{"summary":"垃圾分类","description":"此接口基于本地数据,提供垃圾分类查询服务。输入垃圾名称,即可获取其所属类别(可回收物、有害垃圾、湿垃圾、干垃圾)及投放要求。支持多请求方式,以 JSON 格式输出,适用于环保类应用,助力本地垃圾分类工作。","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"纸屑"},"description":"需要查询投放的垃圾名称,可模糊输入,如:纸屑"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"垃圾分类","description":"此接口基于本地数据,提供垃圾分类查询服务。输入垃圾名称,即可获取其所属类别(可回收物、有害垃圾、湿垃圾、干垃圾)及投放要求。支持多请求方式,以 JSON 格式输出,适用于环保类应用,助力本地垃圾分类工作。","parameters":[{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"纸屑"},"description":"需要查询投放的垃圾名称,可模糊输入,如:纸屑"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"question": "纸屑",
"msg": "纸张类",
"type": "可回收垃圾",
"type_name": "可回收物是指适宜回收和可循环再利用的废弃物。主要包括废玻璃、废金属、废塑料、废纸张、废织物等。",
"tfyq": "1、轻投轻放。\n2、清洁干燥,避免污染。\n3、废纸尽量平整。\n4、立体包装请清空内容物,清洁后压扁投放。\n5、有尖锐边角的,应包裹后投放。",
"tips": "慕名API:http://xiaoapi.cn"
}
此接口基于本地数据提供垃圾分类查询服务。用户输入垃圾名称后,系统返回其所属类别(可回收物、有害垃圾、湿垃圾、干垃圾)及具体投放要求。适用于环保类应用程序,帮助用户快速了解垃圾如何正确分类投放。
/v1/zs_ljfl.php
GET、POST
无需密钥。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| msg | string | 是 | 需要查询投放的垃圾名称,可模糊输入 |
参数取值说明
| 参数 | 取值示例 | 说明 |
|---|---|---|
| msg | 纸屑 | 支持模糊匹配,传入垃圾名称或关键词即可查询其所属分类及投放要求 |
{
"code": 200,
"question": "纸屑",
"msg": "纸张类",
"type": "可回收垃圾",
"type_name": "可回收物是指适宜回收和可循环再利用的废弃物。主要包括废玻璃、废金属、废塑料、废纸张、废织物等。",
"tfyq": "1、轻投轻放。\n2、清洁干燥,避免污染。\n3、废纸尽量平整。\n4、立体包装请清空内容物,清洁后压扁投放。\n5、有尖锐边角的,应包裹后投放。",
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示成功 |
| question | string | 用户查询的垃圾名称 |
| msg | string | 垃圾所属的具体分类,如纸张类、塑料类等 |
| type | string | 垃圾的大类别,包括可回收垃圾、有害垃圾、湿垃圾、干垃圾 |
| type_name | string | 垃圾类型的详细定义与包含范围说明 |
| tfyq | string | 该类垃圾的具体投放要求,多条规则以换行分隔 |
| tips | string | 补充提示信息或来源说明 |
当请求处理失败时,接口将返回包含错误信息的 JSON 响应。
鉴权失败示例
{"code":0,"msg":"未提供调用密钥","errcode":11001}
请求过于频繁示例
{"code":0,"msg":"请求过于频繁,请稍后再试","errcode":11005}
以下为接口可能返回的错误码及含义说明:
| 错误码 | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
curl -X GET "https://xiaoapi.cn/v1/zs_ljfl.php?msg=%E7%BA%B8%E5%B1%91"
// 发送 GET 请求查询垃圾分类
$msg = "纸屑";
$url = "https://xiaoapi.cn/v1/zs_ljfl.php?msg=" . urlencode($msg);
$response = file_get_contents($url);
$result = json_decode($response, true);
print_r($result);
模糊查询支持:参数 msg 支持模糊匹配,可输入垃圾的部分名称进行查询,如“纸”“塑料瓶”等,系统将返回相关分类结果。模糊匹配范围受本地数据库收录内容限制,若未查到结果可尝试更完整的名称或同义词。
返回字段说明:接口返回 type(垃圾类别)、type_name(类别释义)、tfyq(投放要求)等字段,部分字段内容可能包含换行符 \n,建议在展示时进行换行处理。
数据局限性:本接口基于本地数据,分类标准参考上海市等城市标准,实际投放要求可能因地区政策不同而存在差异,建议结合当地分类标准使用。
网络稳定性:建议通过 HTTPS 协议调用本接口,避免因网络传输导致查询失败或返回异常。
免费接口合理使用:本接口免费提供,请勿在生产环境中进行高频批量查询,以免影响服务稳定性。
curl -s "http://xiaoapi.cn/v1/zs_ljfl.php?msg=纸屑"
// 结果将在此处显示