## 郵編查詢（免費）  > 提供全國郵政編碼大全,為你快速準確查郵編 每日100次免費調用 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ## 接口1：通過郵編查詢對應的地名 ### 請求地址 ``` GET https://api.topthink.com/postcode/query ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | postcode | 是 | string | 郵編，如：215001 | | page | 否 | int | 頁數，默認1 | | pagesize | 否 | int | 每頁返回，默認:20,最大不超過50 | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | 參考返回數據 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->postcodeQuery() ->withPostcode('215001') ->request(); dump($result); ``` 返回數據示例： ~~~ { "code": 0, "message": "成功", "data": { "list": [ { "PostNumber": "215001", "Province": "江蘇省", "City": "蘇州市", "District": "平江區", "Address": "廖家巷新光里" }, { "PostNumber": "215001", "Province": "江蘇省", "City": "蘇州市", "District": "平江區", "Address": "龍興橋順德里" } ], "totalcount": 352, "totalpage": 176, "currentpage": 1, "pagesize": "2" }, } ~~~ ## 接口2：省份、城市、地區（縣）關聯的列表 ### 請求地址 ``` GET https://api.topthink.com/postcode/pcd ``` ### 請求參數 無 ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | 參考返回數據 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->postcodePcd() ->request(); dump($result); ``` 返回數據示例： ~~~ { "code": 0, "message": "成功", "data": { { "id":"1", "province":"上海市", "city":[ { "id":"32", "city":"上海市", "district":[ { "id":"798", "district":"南匯區" }, { "id":"799", "district":"盧灣區" }, { "id":"800", "district":"嘉定區" }, { "id":"801", "district":"奉賢區" }, { "id":"802", "district":"寶山區" }, { "id":"803", "district":"崇明縣" }, { "id":"804", "district":"徐匯區" }, { "id":"805", "district":"普陀區" }, { "id":"806", "district":"楊浦區" }, { "id":"807", "district":"松江區" }, { "id":"808", "district":"浦東新區" }, { "id":"809", "district":"虹口區" }, { "id":"810", "district":"金山區" }, { "id":"811", "district":"長寧區" }, { "id":"812", "district":"閔行區" }, { "id":"813", "district":"閘北區" }, { "id":"814", "district":"青浦區" }, { "id":"815", "district":"靜安區" }, { "id":"816", "district":"黃浦區" } ] } ] }, }, } ~~~ ## 接口3：根據相關條件查詢符合條件地區的郵編 ### 請求地址 ``` GET https://api.topthink.com/postcode/search ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | pid | 是 | int | 省份ID | | cid | 是 | int | 城市ID | | did | 否 | int | 區域ID | | q | 否 | string | 地名關鍵字，如:木瀆 | | page | 否 | int | 第幾頁,默認為第1頁 | | pagesize | 否 | int | 每頁顯示條數,(1-50)默認20條， | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | 參考返回數據 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->postcodeSearch() ->withPid(1) ->withCid(32) ->withQ('徐家匯') ->request(); dump($result); ``` 返回數據示例： ~~~ { "code": 0, "message": "成功", "data": { "list":[ { "PostNumber":"200023", "Province":"上海市", "City":"上海市", "District":"盧灣區", "Address":"徐家匯路1-999號(單號)" }, { "PostNumber":"200025", "Province":"上海市", "City":"上海市", "District":"盧灣區", "Address":"徐家匯路28-648號(雙號)" }, { "PostNumber":"200023", "Province":"上海市", "City":"上海市", "District":"盧灣區", "Address":"徐家匯路1-999弄(單號)" }, { "PostNumber":"200025", "Province":"上海市", "City":"上海市", "District":"盧灣區", "Address":"徐家匯路28-648弄(雙號)" } ], "totalcount":4, "totalpage":1, "currentpage":1, "pagesize":20 ... ] }, } ~~~