城市天气ID查询

# 城市天气ID查询API ## 接口说明 根据城市名称查询对应的城市天气ID，支持模糊匹配，返回所有匹配结果。适用于天气查询前获取城市ID的场景。 ## 请求地址 ``` GET/POST https://你的域名/api/weather/cityid.php ``` ## 请求参数 | 参数名 | 必填 | 类型 | 说明 | 示例值 | |--------|------|--------|----------------------------|--------| | city | 是 | string | 需要查询的城市名称 | 朝阳 | ## 返回参数说明 | 参数名 | 类型 | 说明 | 示例 | |---------|---------|----------------------------|--------------------| | success | boolean | 查询状态 | true | | type | string | 匹配类型 | substring | | count | int | 匹配结果数量 | 3 | | results | array | 匹配结果列表 | 见下方说明 | ### results 数组元素说明 | 参数名 | 类型 | 说明 | 示例 | |----------|--------|------------------|------------------| | name | string | 完整城市名称 | 北京市朝阳 | | id | string | 城市天气ID | 101010300 | | type | string | 匹配类型 | substring | | position | int | 匹配位置 | 9 | ## 请求示例 ### GET请求 ``` https://你的域名/api/weather/cityid.php?city=朝阳 ``` ### POST请求 ``` POST /api/weather/cityid.php Content-Type: application/x-www-form-urlencoded city=朝阳 ``` ## 响应示例 ### 成功响应 ```json { "code": 200, "message": "success", "data": { "success": true, "type": "substring", "count": 3, "results": [ { "name": "北京市朝阳", "id": "101010300", "type": "substring", "position": 9 }, { "name": "辽宁省朝阳市朝阳", "id": "101071201", "type": "substring", "position": 9 }, { "name": "吉林省长春市朝阳", "id": "101060110", "type": "substring", "position": 18 } ] }, "time": "2025-02-26 10:30:00" } ``` ### 错误响应 - 缺少参数 ```json { "code": 400, "message": "缺少必要参数: city", "data": { "tip": "请传入城市名称参数", "example": "?city=朝阳 或 ?city=北京" }, "time": "2025-02-26 10:30:00" } ``` ### 错误响应 - 查询失败 ```json { "code": 500, "message": "未找到匹配的城市", "data": { "input": "测试城市", "tip": "请检查城市名称是否正确" }, "time": "2025-02-26 10:30:00" } ``` ## 状态码说明 | 状态码 | 说明 | |--------|----------------------------| | 200 | 查询成功 | | 400 | 请求参数错误 | | 500 | 服务器内部错误或查询失败 |