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