1. 數據可以試用嗎?#
可以。請先遵照控制檯註冊指示,綁定商務後,和他聯繫。商務會給您開放免費體驗。2. 爲什麼有時候請求會報錯"Time out"?#
爲避免異常請求或者攻擊影響整體服務,我們對接口的請求進行了限制。我們默認限制了一分鐘內最多 請求800次,如有更高的頻次要求,請聯繫商務。詳細規則見【API指南 - HTTP 注意事項】。3. 接口可以直接應用到前端頁面嗎?#
不可以。爲了保障您的數據安全,請不要將接口直接應用於前端頁面,否則容易泄露自身密鑰。請先將數據拉取至自己的服務器,然後再應用於前端。4. 首次數據接入應該如何做?#
列表接口調用:
首次獲取,根據入參id循環獲取全量數據(第一次調用入參id默認爲空,後續入參id爲前一次返回數據的最大id+1)。
判斷total=0或results爲空,全量數據獲取結束(記錄全量數據中的最大更新時間updated_at)。
全量數據獲取結束,後續進行增量更新。
增量更新,根據入參time循環獲取變動數據(第一次調用入參time爲步驟2中記錄的最大更新時間updated_at+1,同上,後續入參time爲前一次返回數據的最大更新時間updated_at+1)。
total=0或results爲空,增量更新結束(記錄最大更新時間updated_at)。
保持增量更新即可(每1分鐘/次)。5. 增量更新time入參查詢時,返回數據總數total大於limit的限制,該如何設置?#
使用time查詢,因爲存在同一更新時間有多條數據,而同一更新時間的數據是同步返回的,所以接口返回數量是limit限制數的前後範圍內;limit主要用於id查詢,因爲id是唯一的,所以最大返回數就是limit;time查詢,limit默認即可,不需要額外使用。6. IP 白名單和接口授權後,爲什麼請求接口還是提示 IP 受限或者接口未授權?#
IP 白名單和接口權限我們設置了時效機制,客戶配置 IP 地址或者商務授予接口權限後一分鐘生效。7. 我們需要越南語和印尼語的數據,能支持嗎?#
支持。我們的數據應用了多語言輸出,可自由選擇中、英等主流語言,並輸出對應的語言內容。助力您的全球化數據要求。不需要多次填寫,文件將 Headers 參數:app_id,app_secret 設置爲變量,只需要第一次調用時填寫即可;需要注意的是清除網頁緩存後需要再次填寫。9. 請求的時候沒有達到每分鐘最大請求次數,爲什麼還是會報錯"Time out"?#
我們的每個接口也有自己的請求頻次。爲了數據請求的穩定性,我們爲每個接口設置了最大的請求次數。詳見【常見問題 - 接口最大限制頻率】。10. 企業用戶能否定製方案?#
可以。我們提供定製化企業套餐,支持根據數據量、請求要求、時效性等維度量身定製方案。歡迎通過官網聯繫商務團隊詳談。如果需要進一步細化行業場景案例或技術接入文件,請聯繫商務協助補充。