街道办事处API接口介绍
API接口查询
应广大用户的强烈要求，街道办事处查询API接口已公测上线了。
| 金额（元） | 查询次数 | 单次查询费用 | 备注 |
|---|---|---|---|
| 1200.00 | 1万 | 0.12元 | 1万次起 |
| 6000.00 | 10万 | 0.06元 | 10万=<查询次数<100万 |
| 35000.00 | 100万 | 0.035元 | 100万=<查询次数<500万 |
| 140000.00 | 500万 | 0.028元 | 500万=<查询次数<1000万 |
| 200000.00 | 1000万 | 0.020元 | 1000万次以上 |
特别说明：采取预充值的方式进行查询，每次查询追加一次查询记录。
该查询次数有效期为2年，逾期未使用完恕不退款。
什么是API接口 ？
通过API接口，软件组件或Web服务可与外界数据进行实时交互传输。好比电脑需要调用手机里面的信息，这时候你会拿一根数据线🧵将电脑手机连接起来，电脑和手机上连接数据线的接口就是传说中的API接口。
API接口可以用来干什么？
通过API接口，可以直接从邮编库的服务器里面调取街道办事处实时数据👨💻，也就是您可以将邮编库街道办事处查询的这项功能嵌入到您自己的网站或者APP中供用户使用。
如何调用API接口？
接口地址：
https://www.youbianku***********.php
请求示例：
https://www.youbianku***********.php?address=&key=
请求参数：
| 名称 | 类型 | 必填 | 示例值 |
|---|---|---|---|
| address | string | 是 | 武汉市江汉区江兴路79号 |
| key | string | 是 | 您申请的key |
查询成功返回参数：
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| msg | string | 查询成功 | msg更多返回示例请查看下方的msg返回值 |
| results | list | [...] | 数据查询结果 |
| count | string | 1 | 实际查询次数 |
| remaincount | int | 999 | 剩余查询次数 |
查询成功返回示例值：
{
"msg": "查询成功",
"results": [
{
"province": "湖北省",
"province_code": "42",
"city": "武汉市",
"city_code": "420100000000",
"area": "江汉区",
"area_code": "420103000000",
"street": "汉兴街街道",
"street_code": "420103013000",
"village": "常远里社区居委会",
"village_code": "420103013001",
"address": "湖北省武汉市江汉区江兴路|79号"
}
],
"count": "6",
"remaincount": 994
}
msg返回值：
| 名称 | 示例值 | 描述 |
|---|---|---|
| msg | 地址格式不标准 | 查询地址为空或者是纯数字等情况 |
| msg | 身份认证失败 | 缺失必填的key |
| msg | 地址解析失败 | 查询的地址不标准 |
| msg | 查询成功 | 返回结果 |
| msg | 余额不足 | 查询次数不足 |
查询失败返回示例值：
{
"msg": "地址格式不标准",
"results": []
}
扣费说明：
| 名称 | 示例值 | 是否扣费 |
|---|---|---|
| msg | 地址格式不标准 | 否 |
| msg | 身份认证失败 | 否 |
| msg | 地址解析失败 | 是 |
| msg | 查询成功 | 是 |
| msg | 余额不足 | 否 |
如需获取完整接入开发文档及收费细则，请发送邮件至：webmaster@youbianku.com，紧急情况请拨打：027-82358178
