1. 從這裡開始
- Housing Market API 文件、PDF 指南與帳務正在更新整合 Housing Market API 所需的一切都在管理主控台中:以 API 實際運行的同一份規格建置的文件、供您自有工具使用的 OpenAPI 檔案,以及可下載為 PDF 的整合指南。您的信用卡與發票只需一鍵即可查看。本教學將帶您瀏覽文件、找到 OpenAPI 檔案與指南,並說明帳務功能的位置。
- 查看 Housing Market API 涵蓋哪些國家正在更新Housing Market API 的涵蓋範圍頁面會顯示 API 可涵蓋的所有國家,並依地區分組:亞太地區、中東、歐洲與美洲。每個國家的資料都來自 Housing Market Group 的入口網站,您可以逐一購買國家、購買整個地區,或購買全球涵蓋範圍。標示為「更新中」的國家尚未開放購買。每個國家名稱都會以新分頁連至其入口網站,讓您查看資料背後的物件。本教學將開啟涵蓋範圍頁面並逐項說明。您無需帳戶。
2. 您的帳戶
- 如何登入 Housing Market API 管理主控台正在更新Housing Market API 管理主控台是您選擇國家與方案、註冊伺服器位址、付款並取得 API 金鑰的地方。您可以使用 Housing Market 帳戶登入,也就是您用於入口網站、CRM 或其他任何 Housing Market 產品的同一組電子郵件與密碼。本教學將開啟管理主控台的登入頁面,說明需要輸入的內容,並指出建立帳戶與忘記密碼的連結,以及頁首的語言選單。
- 如何建立 Housing Market API 帳戶正在更新Housing Market API 讓您的軟體依國家取得 Housing Market 入口網站上已發佈的物件資料。第一步是在 API 管理主控台建立帳戶。本教學將開啟註冊頁面、輸入電子郵件地址與密碼、說明以電子郵件寄送的確認碼,並示範後續步驟。
- 在 Housing Market API 管理主控台透過連結驗證您的電子郵件正在更新只要建立帳號,您就能登入 Housing Market API 管理主控台,但必須先完成電子郵件地址驗證才能使用。本教學以尚未驗證的地址登入,說明「請查看您的電子郵件」頁面的內容,示範如何索取新的驗證郵件、如何更正輸入錯誤的地址,最後開啟郵件中的連結並按下其中的按鈕。全程無須輸入任何代碼。
- 如何透過電子郵件連結建立 Housing Market API 帳戶正在更新Housing Market API 可讓您的軟體依國家逐一取得 Housing Market 入口網站上已發布的物件資料。第一步是在 API 管理主控台建立帳戶。本教學將開啟註冊頁面、輸入電子郵件地址與密碼,說明以電子郵件寄送的確認連結(無需輸入任何代碼),並示範後續步驟。
3. 方案、國家與付款
- 如何為 Housing Market API 選擇國家與方案正在更新Housing Market API 依涵蓋範圍銷售:單一國家、整個區域或全球,並可按月或按年計費。方案分為兩種,Standard 提供物件資料及其所有細節,Advanced 則在彙總市場 Insights 推出後額外納入,兩者價格相同。本教學將選擇國家、比較區域與全球方案、挑選方案與計費週期,然後繼續下一步。
- 如何新增國家或升級您的 Housing Market API 方案正在更新您的 Housing Market API 方案可隨您一同成長:新增國家、改為區域或全球範圍,或升級至 Advanced,付款確認後同一組金鑰即可涵蓋新範圍。本教學將開啟方案變更、新增一個國家,並說明新增與移除的計費方式。
- Housing Market API 定價:選擇國家、區域或全球正在更新Housing Market API 依涵蓋範圍販售:個別國家、整個區域或全球,並可按月或按年計費。共有兩種方案,Standard 提供物件與其完整詳細資料,Advanced 則另外加入彙總的市場 Insights,兩者價格相同。本教學將選擇國家、比較區域與全球方案、挑選方案與計費週期,然後繼續下一步。
- 新增國家或升級您的 Housing Market API 方案(同一組金鑰)正在更新您的 Housing Market API 方案可隨您一同成長:新增國家、改為區域或全球範圍,或升級至 Advanced,付款確認後同一組金鑰即可涵蓋新範圍。本教學將開啟方案變更、新增一個國家,並說明新增與移除的計費方式。
- Housing Market API:付款未成功?重新付款正在更新若您的 Housing Market API 方案首次付款未成功,管理主控台會在您的儀表板上顯示說明,並提供「重新付款」按鈕。系統尚未建立任何 API 金鑰,也未保留任何資料,因此您可以使用同一張卡或另一張卡再試一次;付款成功後,金鑰即會立即建立。本教學將說明這則訊息,以及「重新付款」會帶您前往何處。
- Housing Market API:在方案中新增或移除國家/地區正在更新在 Housing Market API 的國家方案中,您可以在「您的國家/地區」頁面新增或移除國家/地區。在任何費用產生之前,確認步驟會顯示變更內容、新增時立即收取的金額、變更後的價格以及生效時間。本教學示範新增一個國家/地區,接著說明如何移除。
4. 金鑰與第一次請求
- 如何為 Housing Market API 註冊您的伺服器 IP正在更新Housing Market API 金鑰僅能從您所註冊的那一個伺服器位址使用,付款前您需先接受 API 條款。本教學將輸入伺服器的 IP 位址、說明為何瀏覽器顯示的位址通常不是正確的位址、閱讀條款步驟,並一路進行到安全付款頁面。
- 如何取得您的 Housing Market API 金鑰 — 僅顯示一次正在更新首次付款確認後,您的 Housing Market API 金鑰即已就緒,並且只會顯示一次。本教學將開啟金鑰、複製金鑰,並說明應將其保存在何處,以及如何在每次請求中一併傳送。
- 您對 Housing Market API 的第一次請求正在更新取得金鑰後,只需一次 HTTPS 請求,即可取回您已付費國家的物件資料。本教學將開啟文件中的範例請求,以 ping 驗證金鑰,查詢泰國的物件,解讀回應內容與其游標,並取得下一頁資料。
- Housing Market API 儀表板 — 用量、金鑰輪替與 IP正在更新Housing Market API 儀表板會顯示您的涵蓋範圍、今日與本月已使用的配額、您的金鑰,以及其運作所依據的伺服器位址。本教學將解讀涵蓋範圍與用量表格,說明金鑰輪替及其 24 小時重疊期,並示範如何變更已登錄的伺服器位址。
- Housing Market API:管理主控台中的公告正在更新當 Housing Market Group 有事項需要通知您,例如公告或預定的維護時段,內容會以一條公告列顯示在您的 Housing Market API 管理主控台頁首下方。本教學說明公告的呈現方式、如何開啟其「瞭解詳情」連結,以及如何關閉公告,讓它在該瀏覽器中不再影響您的操作。本影片中的公告皆為範例。

