邮编区域互查官方提供 MCP 服务,覆盖全部三个接入点,可在支持 MCP 的 AI 客户端里直接调用。
邮编→地区是相对稳定的数据,适合本地缓存,能显著减少免费接口的调用次数、避免档位限制。
分页参数 page(页码),每页最大 maxResult 条(实测返回 20)。
三个接入点实测都会返回 areacode(电话区号,如 0595、0871),但官方参数表未单列该字段。
邮编区域互查返回的是行政区划文本(省/市/区/街道),本身不含经纬度,无法直接标点。
接入点3(1917-3)按 province/city/area/county 逐级筛选,返回邮编(字段名 code)。
接入点2(1917-2)是「地区 → 邮编」:传 area,返回邮编。
接入点1(1917-1)是「邮编 → 地区」:传入 6 位 code,返回省/市/区/街道与电话区号。
有两层返回码:showapi_res_code(系统级,0 成功)与 showapi_res_body.ret_code(业务级,0 成功 / -1 失败)。
返回分两层:系统级(showapi_res_code 等)包裹业务级 showapi_res_body,业务数据都在 showapi_res_body 里。
邮编区域互查是免费接口,注册 ShowAPI 账号、拿到 AppKey 即可调用,无付费门槛。
邮编区域互查指南总目录
官方提供接口级 OpenAPI 3.0 文档,覆盖全部接入点。
高频问题集中在:_id 从哪来、ret_code -1 怎么解、免费档位限制、更新时间。
官方提供接口级 MCP 服务 showapi-mcp-2145,覆盖全部接入点。
覆盖 Python(requests)、cURL、Node.js(fetch)、Java(HttpURLConnection) 四语言。



