免费注册 用户登录
已开放 7 个接口 · 2 个免费

一站式 API 服务市场

聚合企业工商、实名认证、金融风控、AI 能力等优质接口，免费试用 + 按量计费，注册即用，分钟级完成接入。

热门搜索： 企业工商实名认证银行卡四要素OCR 识别物流查询
7
对外开放接口
2
免费接口
30
累计调用次数
X-API-Key
免签名，仅校验请求头

接口清单

下列接口均已在 /api 下提供独立文档页，数据由后台接口管理实时同步； 没有列出来的能力，说明当前还未对外开放。

共 1 个
全部 7 成品油价格 4 行政区划 1 智能解析 1 基础工具 1
热门
🗺️
行政区划查询
行政区划 region.query

免费接口，按行政区划代码/名称/拼音/省市区/邮编查询省市县（区）三级数据，数据每周日自动同步更新

GET /openapi/region/query
请求参数 code、keyword、province、city、zipCode、level、limit（至少填一个）
省市区三级含邮政编码每周日同步
¥0.01/次 按次计费
接口文档

统一调用约定

所有接口遵循同一套规则，对接一次即可复用全部接口。

服务地址 https://www.xujian.tech/openapi
请求方式 GET（绝大多数接口为 GET，参数放在 Query String）； /openapi/address/parse 同时支持 POST（text 放 JSON body）， 地址含逗号、换行等特殊字符时建议用 POST
鉴权方式 请求头 X-API-Key 携带控制台申请的 API Key。 不做签名、不做加密、不校验时间戳， 缺失或无效会返回 code=500。
响应格式 JSON，application/json;charset=UTF-8。 统一结构 {code, msg, data}，code=0 表示成功， 失败时 data 为 null、msg 为具体原因。
计费位置 服务端在鉴权通过后按后台配置计费并把金额写入交易流水，返回体中的 balance 是扣费后的账户余额；免费接口金额为 0，不扣余额。
cURL 
curl -s "https://www.xujian.tech/openapi/region/query?level=1&limit=100" \
  -H "X-API-Key: 你的APIKey"
Java（Hutool） 
String body = HttpRequest.get("https://www.xujian.tech/openapi/region/query")
        .form("level", 1)
        .form("limit", 100)
        .header("X-API-Key", apiKey)
        .timeout(5000)
        .execute()
        .body();

JSONObject json = JSONUtil.parseObj(body);
if (json.getInt("code") == 0) {
    JSONArray provinces = json.getJSONObject("data").getJSONArray("list");
}
Python 
import requests

resp = requests.get(
    "https://www.xujian.tech/openapi/region/query",
    params={"level": 1, "limit": 100},
    headers={"X-API-Key": API_KEY},
    timeout=5,
)
data = resp.json()
if data["code"] == 0:
    for item in data["data"]["list"]:
        print(item["code"], item["name"])

提示：示例代码以免费的行政区划查询为例，换成其他接口只需替换路径与参数，鉴权方式完全一致。

计费一览

收费方式与单价取自后台「接口管理」，调整后立即在本页生效。

接口 编码 请求路径 计费方式 单价 文档
⛽ 实时发改委价格查询 oilprice.realtime /openapi/oilprice/realtime 按次计费 ¥0.01/次 查看
🛢️ 全量发改委价格查询 oilprice.all /openapi/oilprice/all 按次计费 ¥5/次 查看
🔔 提前查询发改委价格 oilprice.advance /openapi/oilprice/advance 按年付费 ¥360/年 查看
📅 发改委调价周期查询 oilprice.cycle /openapi/oilprice/cycle 免费 免费 查看
🗺️ 行政区划查询 region.query /openapi/region/query 按次计费 ¥0.01/次 查看
📮 自然语言地址解析 address.parse /openapi/address/parse 按次计费 ¥0.02/次 查看
🌐 查询自己的公网IP ip.query /openapi/ip/query 免费 免费 查看

按次计费的接口在调用前校验余额，余额不足时返回「余额不足，请先充值。」并且不会扣费； 包年的接口需要后台为客户开通授权，授权有效期内调用不再额外扣费。 地址信息解析（address.parse）采用「先预鉴权、成功后再扣费」：识别不出地址或省级行政区时返回失败且不收费。 充值与授权可可联系微信xujian_cq。

三步开始调用

没有商务流程，注册后自己在控制台就能完成全部操作。

1
注册开发者账号

注册后即可登录控制台，不需要实名认证，免费接口马上可以调用。

2
创建 API Key

在控制台创建 API Key 并复制明文，放到请求头 X-API-Key 中即可，无需 AppSecret 与签名。

3
调用并查看账单

参照接口文档发请求，控制台可查看调用明细、交易流水与账户余额； 付费接口余额不足时联系充值即可。

常见问题

调用接口需要签名或加密吗？

不需要。全部接口只校验请求头中的 API Key，不做签名、不校验时间戳、不做加密。 建议使用 HTTPS 并在服务端调用，避免在浏览器或客户端代码中泄露 Key。

哪些接口是免费的？

当前 2 个接口为免费（在上表与接口卡片中标注「免费」）。 免费接口不扣费、不消耗账户余额，也不需要单独授权，仍会写一条金额为 0 的流水并累加调用次数，方便统计用量。

标注「需后台授权」的接口怎么开通？

包月 / 包年类接口由后台为该客户开通授权后才能调用，授权有效期内不再额外扣费； 未授权或授权过期会返回「接口未授权或授权已过期」，不扣费。需要开通可可联系微信xujian_cq。

付费接口余额不足会怎样？

按次计费的接口在调用前校验余额，余额不足时返回「余额不足，请先充值。」，本次不扣费也不会写扣费流水。 充值后重试即可，充值可可联系微信xujian_cq。

油价数据多久更新一次？建议怎么拉取？

国家发改委约每 10 个工作日调整一次成品油价格，一年约 24 次。 建议先用免费的调价周期接口拿到当年的生效日期列表，只在调价日当天调用油价接口，其余时间使用本地缓存。

行政区划数据更新频率？能一次拉全吗？

数据每周日凌晨 03:00 自动全量同步一次，管理端也支持手动立即同步。 单次最多返回 100 条：传 level=1 可一次拿到全部省级记录， 传 level=2 拿到地市级，配合 province、city 即可完成三级联动。

地址信息解析（address.parse）能做什么？解析失败会扣费吗？

把一段文本（如「张三，13020260925，重庆市铜梁区白龙大道龙腾盛世」）解析成 姓名、电话、地址文字，以及省 / 市 / 区县三级规范名称与 6 位 adcode： 大模型负责抽取，行政区划库负责规范化与补代码，兼容直辖市、简称异名（如「四川」↔「四川省」）。

解析不出地址或省级行政区时不会扣费：接口采用「先预鉴权、业务成功后再扣费」的两段式流程， 文本为空 / 超长、大模型不可用、识别不出省级时直接返回失败，不扣费也不写扣费流水。

详见 地址信息解析接口文档。

没有 API Key 可以直接调用吗？

不可以。缺少或无效的 API Key 会返回 code=500。注册账号后在控制台创建 Key 即可使用。

现在开始，免费试用全部接口

注册即送调用额度，按量计费，无最低消费，随用随停。

免费注册
扫码添加微信
联系作者 · 微信二维码

微信号：xujian_cq

接口对接、充值 / 授权、定制需求都可以直接聊