郵政編碼查詢API接口介紹
郵政編碼查詢API接口介紹
| 金額（元） | 查詢次數 | 單次查詢費用 | 備註 |
|---|---|---|---|
| 600.00 | 1萬 | 0.06元 | 1萬次起 |
| 3000.00 | 10萬 | 0.03元 | 10萬=<查詢次數<100萬 |
| 15000.00 | 100萬 | 0.015元 | 100萬以上 |
特別說明：採取預充值的方式進行查詢，每次查詢追加一次查詢記錄。
該查詢次數有效期為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": "湖北省",
"city": "武漢市",
"district": "江漢區",
"postcode": "430024",
"address": "湖北省武漢市江漢區江興路79號"
}
],
"count": "6",
"remaincount": 994
}
msg返回值：
| 名稱 | 示例值 | 描述 |
|---|---|---|
| msg | 地址格式不標準 | 查詢地址為空或者是純數字等情況 |
| msg | 身份認證失敗 | 缺失必填的key |
| msg | 地址解析失敗 | 查詢的地址不標準 |
| msg | 查詢成功 | 返回結果 |
| msg | 餘額不足 | 查詢次數不足 |
查詢失敗返回示例值：
{
"msg": "地址格式不標準",
"results": []
}
扣費說明：
| 名稱 | 示例值 | 是否扣費 |
|---|---|---|
| msg | 地址格式不標準 | 否 |
| msg | 身份認證失敗 | 否 |
| msg | 地址解析失敗 | 是 |
| msg | 查詢成功 | 是 |
| msg | 餘額不足 | 否 |
