{
    "ok": true,
    "id": "14",
    "name": "全国行政区查询",
    "description": "（2026年更新，如有差错，纯属意外）本API支持查询全国（指中华人民共和国）各地行政区（包括港澳台特别行政区）",
    "method": "GET/POST",
    "endpoint": "https://api.mangox.asia/api/region/",
    "example": "https://api.mangox.asia/api/region/index.php?token=您的密钥&action=功能&name=内容",
    "status": "ok",
    "free": true,
    "parameters": [
        {
            "name": "token",
            "type": "string",
            "required": true,
            "desc": "登录获取的用户密钥"
        },
        {
            "name": "action",
            "type": "string",
            "required": false,
            "desc": "功能类型，默认 list；可选值：list（列出所有省级行政区）、cities（查询省级下辖市级行政区）、province（查询市级所属省级行政区）、search（模糊搜索行政区）"
        },
        {
            "name": "name",
            "type": "string",
            "required": false,
            "desc": "查询内容；action 为 cities 时填省级行政区名称，为 province 时填市级行政区名称，为 search 时填搜索关键词"
        },
        {
            "name": "提示",
            "type": "提示",
            "required": false,
            "desc": "本接口每分钟限制 30 次请求"
        }
    ],
    "required_count": 1,
    "response": "台湾省下辖的市级行政区（共22个）：\r\n1. 台北市\r\n2. 新北市\r\n3. 桃园市\r\n4. 台中市\r\n5. 台南市\r\n6. 高雄市\r\n7. 基隆市\r\n8. 新竹市\r\n9. 嘉义市\r\n10. 新竹县\r\n11. 苗栗县\r\n12. 彰化县\r\n13. 南投县\r\n14. 云林县\r\n15. 嘉义县\r\n16. 屏东县\r\n17. 宜兰县\r\n18. 花莲县\r\n19. 台东县\r\n20. 澎湖县\r\n21. 金门县\r\n22. 连江县",
    "status_codes": [
        {
            "code": "200",
            "message": "解析成功"
        },
        {
            "code": "400",
            "message": "参数错误"
        },
        {
            "code": "403",
            "message": "无效密钥"
        },
        {
            "code": "404",
            "message": "源站缺失"
        },
        {
            "code": "408",
            "message": "请求超时"
        },
        {
            "code": "410",
            "message": "解析失败"
        },
        {
            "code": "422",
            "message": "解析错误"
        }
    ],
    "faqs": [
        {
            "q": "如何调用 全国行政区查询 接口？",
            "a": "使用 GET/POST 方式请求 https://api.mangox.asia/api/region/，按需携带「请求参数」中的字段即可获取返回数据。若接口需要密钥，请在本页「快速开始」处点击「填充 Token」，输入后示例地址与代码中的「您的密钥」会自动替换为你的 token，直接复制即可使用。"
        },
        {
            "q": "全国行政区查询 接口支持哪些请求方式？",
            "a": "目前支持 GET/POST 请求方式，请求地址为 https://api.mangox.asia/api/region/。接口同时兼容 cURL、Python requests、Java HttpClient、JavaScript fetch 等常见客户端。"
        },
        {
            "q": "全国行政区查询 接口是免费的吗？",
            "a": "是的，该接口由 MGO-API 免费开放，无需付费即可调用，也不限制调用次数（合理使用即可）。"
        },
        {
            "q": "调用 全国行政区查询 接口返回错误怎么办？",
            "a": "请对照「状态码说明」排查：400 参数错误（检查参数名与类型）、403 无效密钥（检查 token 是否正确）、404 源站缺失（源站资源不存在）、408 请求超时（稍后重试或降低并发）、410 解析失败（源站内容已失效）、422 解析错误（源站返回格式异常）。若持续报错，可联系站长协助处理。"
        },
        {
            "q": "接口提示「无效密钥 / 403」该如何处理？",
            "a": "请确认 token 参数是否正确、是否已过期。可在本页「快速开始」中点击「填充 Token」，输入你的密钥后，示例地址与代码里所有「您的密钥」占位内容都会自动替换，直接复制即可使用。"
        },
        {
            "q": "接口响应很慢或者超时（408）怎么办？",
            "a": "可先重试一次；若仍超时，可能是源站临时波动。建议客户端设置 10 秒以上超时，并避免高频并发请求，稍后再试通常即可恢复。"
        },
        {
            "q": "如何导出这份接口文档？",
            "a": "在页面顶部点击「导出文档」按钮，在弹出的窗口中选择 Markdown（.md）、Word（.doc）或纯文本（.txt）格式，导出文件会附带站点域名、原文档地址与导出时间，方便离线查阅或写进项目文档。也可以在地址后追加 &format=json 获取结构化 JSON，或追加 &format=md 获取 Markdown 纯文本，便于 AI 与程序抓取。"
        },
        {
            "q": "遇到问题如何联系站长？",
            "a": "节假日白天可联系站长 QQ：2201040041（其他时段留言即可，看到会尽快回复）。"
        }
    ],
    "keywords": [
        "全国行政区查询",
        "全国行政区查询接口",
        "全国行政区查询API",
        "全国行政区查询接口文档",
        "全国行政区查询怎么调用",
        "MGO-API",
        "免费API",
        "API接口",
        "接口文档",
        "GET/POST接口"
    ],
    "doc_url": "https://api.mangox.asia/doc?id=14",
    "json_url": "https://api.mangox.asia/doc?id=14&format=json",
    "markdown_url": "https://api.mangox.asia/doc?id=14&format=md",
    "provider": {
        "name": "MGO-API",
        "url": "https://api.mangox.asia/"
    }
}