街道辦事處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 | 餘額不足 | 否 |
如需獲取完整接入開發文檔及收費細則，請發送郵件至：[email protected]，緊急情況請撥打：027-82358178
