全国行政
夏柔API 官方文档
全国省市区镇村【五级版】,数据来源于国家统计局
基本说明:
接口地址:https://zj.v.api.aa1.cn/api/xz/
返回格式:json
请求方式:get
请求示例:https://zj.v.api.aa1.cn/api/xz/?code=654028207203
请求参数说明:
名称 类型 必填 说明
code string 必填 查询的区划代码
返回参数说明:
名称 类型 说明
code string 状态码
ID string 查询的区划代码
msg string 查询结果返回
Name string 查询的区划代码结果
Province string 查询的省份
City string 查询的城市
District string 查询的区/县
Tow string 查询的街道/乡
Villag string 查询的村/社区
LevelType string 查询的区划等级:1~5级
JSON返回示例:
{
	"code": 200,
	"ID": "654028207203",
	"msg": "查询成功,查询花费0.0002秒",
	"data": {
		"Name": "阔克托干村",
		"Province": "新疆维吾尔自治区",
		"City": "伊犁哈萨克自治州",
		"District": "尼勒克县",
		"Tow": "喀拉托别乡",
		"Villag": "阔克托干村",
		"LevelType": "5"
	}
}
服务级错误码参照
错误码 说明
- -
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2023/12/10 12:56
 */
class freeApi
{
    private $apiUrl;

    public function __construct()
    {
        $this->apiUrl = 'https://zj.v.api.aa1.cn/api/xz/?code=654028207203';
    }

    /**
     * 获取结果
     * @return array
     */
    public function getResult()
    {
        return file_get_contents($this->apiUrl);
    }
}
package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

const (
	APIURL   = "https://zj.v.api.aa1.cn/api/xz/?code=654028207203"
)

func main() {
	queryUrl := fmt.Sprintf("%s",APIURL)
	resp, err := http.Get(queryUrl)
	if err != nil {
		log.Println(err)
		return
	}

	defer resp.Body.Close()

	body, err := ioutil.ReadAll(resp.Body)

	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}