郵政編碼查詢API接口介紹
來自Youbianku
郵政編碼查詢API接口介紹
| 金額（元） | 查詢次數(shù) | 單次查詢費用 | 備注 |
|---|---|---|---|
| 600.00 | 1萬 | 0.06元 | 1萬次起 |
| 3000.00 | 10萬 | 0.03元 | 10萬=<查詢次數(shù)<100萬 |
| 15000.00 | 100萬 | 0.015元 | 100萬以上 |
特別說明：采取預(yù)充值的方式進行查詢，每次查詢追加一次查詢記錄。
該查詢次數(shù)有效期為2年，逾期未使用完恕不退款。
什么是API接口？
通過API接口，軟件組件或Web服務(wù)可與外界數(shù)據(jù)進行實時交互傳輸。好比電腦需要調(diào)用手機里面的信息，這時候你會拿一根數(shù)據(jù)線??將電腦手機連接起來，電腦和手機上連接數(shù)據(jù)線的接口就是傳說中的API接口。
API接口可以用來干什么？
通過API接口，可以直接從郵編庫的服務(wù)器里面調(diào)取任意地址郵編查詢的實時數(shù)據(jù)?????，也就是您可以將郵編庫任意地址郵編查詢的這項功能嵌入到您自己的網(wǎng)站或者APP中供用戶使用。
如何調(diào)用API接口？
接口地址：
https://www.youbianku***********.php
請求示例：
https://www.youbianku***********.php?address=&key=
請求參數(shù)：
| 名稱 | 類型 | 必填 | 示例值 |
|---|---|---|---|
| address | string | 是 | 武漢市江漢區(qū)江興路79號 |
| key | string | 是 | 您申請的key |
查詢成功返回參數(shù)：
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| msg | string | 查詢成功 | msg更多返回示例請查看下方的msg返回值 |
| results | list | [...] | 數(shù)據(jù)查詢結(jié)果 |
| count | string | 1 | 實際查詢次數(shù) |
| remaincount | int | 999 | 剩余查詢次數(shù) |
查詢成功返回示例值：
{
"msg": "查詢成功",
"results": [
{
"province": "湖北省",
"city": "武漢市",
"district": "江漢區(qū)",
"postcode": "430024",
"address": "湖北省武漢市江漢區(qū)江興路79號"
}
],
"count": "6",
"remaincount": 994
}
msg返回值：
| 名稱 | 示例值 | 描述 |
|---|---|---|
| msg | 地址格式不標準 | 查詢地址為空或者是純數(shù)字等情況 |
| msg | 身份認證失敗 | 缺失必填的key |
| msg | 地址解析失敗 | 查詢的地址不標準 |
| msg | 查詢成功 | 返回結(jié)果 |
| msg | 余額不足 | 查詢次數(shù)不足 |
查詢失敗返回示例值：
{
"msg": "地址格式不標準",
"results": []
}
扣費說明：
| 名稱 | 示例值 | 是否扣費 |
|---|---|---|
| msg | 地址格式不標準 | 否 |
| msg | 身份認證失敗 | 否 |
| msg | 地址解析失敗 | 是 |
| msg | 查詢成功 | 是 |
| msg | 余額不足 | 否 |
