接口速览

• 接口名称：全国行政区查询
• 请求方式：GET/POST
• 接口地址：https://api.mangox.asia/api/region/
• 请求参数：共 4 个，其中必填 1 个
• 返回格式：JSON
• 费用说明：完全免费，无需付费，不限调用次数
• 当前状态：运行正常

使用 GET/POST 方式请求以下地址即可获取数据。 若接口需要密钥，点击 填充 Token，示例地址与代码中的「您的密钥」会自动替换为你的 token。

<?php
$url = "https://api.mangox.asia/api/region/index.php?token=您的密钥&action=功能&name=内容";

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_CUSTOMREQUEST  => "GET/POST",
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

接口信息

接口地址（api-url）

https://api.mangox.asia/api/region/ 复制

请求方式

GET/POST

示例地址

https://api.mangox.asia/api/region/index.php?token=您的密钥&action=功能&name=内容 复制

请求参数

返回示例

台湾省下辖的市级行政区（共22个）：
1. 台北市
2. 新北市
3. 桃园市
4. 台中市
5. 台南市
6. 高雄市
7. 基隆市
8. 新竹市
9. 嘉义市
10. 新竹县
11. 苗栗县
12. 彰化县
13. 南投县
14. 云林县
15. 嘉义县
16. 屏东县
17. 宜兰县
18. 花莲县
19. 台东县
20. 澎湖县
21. 金门县
22. 连江县

状态码说明

常见问题

如何调用 全国行政区查询 接口？

使用 GET/POST 方式请求 https://api.mangox.asia/api/region/，按需携带「请求参数」中的字段即可获取返回数据。若接口需要密钥，请在本页「快速开始」处点击「填充 Token」，输入后示例地址与代码中的「您的密钥」会自动替换为你的 token，直接复制即可使用。

全国行政区查询 接口支持哪些请求方式？

目前支持 GET/POST 请求方式，请求地址为 https://api.mangox.asia/api/region/。接口同时兼容 cURL、Python requests、Java HttpClient、JavaScript fetch 等常见客户端。

全国行政区查询 接口是免费的吗？

是的，该接口由 MGO-API 免费开放，无需付费即可调用，也不限制调用次数（合理使用即可）。

调用 全国行政区查询 接口返回错误怎么办？

请对照「状态码说明」排查：400 参数错误（检查参数名与类型）、403 无效密钥（检查 token 是否正确）、404 源站缺失（源站资源不存在）、408 请求超时（稍后重试或降低并发）、410 解析失败（源站内容已失效）、422 解析错误（源站返回格式异常）。若持续报错，可联系站长协助处理。

接口提示「无效密钥 / 403」该如何处理？

请确认 token 参数是否正确、是否已过期。可在本页「快速开始」中点击「填充 Token」，输入你的密钥后，示例地址与代码里所有「您的密钥」占位内容都会自动替换，直接复制即可使用。

接口响应很慢或者超时（408）怎么办？

可先重试一次；若仍超时，可能是源站临时波动。建议客户端设置 10 秒以上超时，并避免高频并发请求，稍后再试通常即可恢复。

如何导出这份接口文档？

在页面顶部点击「导出文档」按钮，在弹出的窗口中选择 Markdown（.md）、Word（.doc）或纯文本（.txt）格式，导出文件会附带站点域名、原文档地址与导出时间，方便离线查阅或写进项目文档。也可以在地址后追加 &format=json 获取结构化 JSON，或追加 &format=md 获取 Markdown 纯文本，便于 AI 与程序抓取。

遇到问题如何联系站长？

节假日白天可联系站长 QQ：2201040041（其他时段留言即可，看到会尽快回复）。