Hi,開發者您好!,歡迎使用114Best開放平臺。以下內容,是您接入服務的一些基本介紹,希望您能夠在這里找到適合您業務項目,感謝您的使用!
接口協議使用HTTP,為發起方提供訪問的URL規范,發起方使用HTTP 【POST】方法發送請求報文并得到應答報文。
雙方交互內容發送的格式均為UTF-8。
外圍與開放平臺之間交互同步等待超時時間建議最大超時時間設置為5秒。
調用接口時需要對請求參數進行簽名驗證,服務器也會對該請求參數進行驗證是否合法的。
將接口名fun和apiID參數a拼接后,再拼接請求參數拼接,最后拼接當前時間(精確到小時,如yyyyMMddHH)及apiKey進行MD5加密并賦值給公共入參c。
以GetGongShangByWord接口為例:
c= MD5(“GetGongShangByWord”+ a + city + word + yyyyMMddHH(當前時間) + apiKey)
注意:”+”為拼接的意思
1.每次參與MD5的時間參數,應取系統當前時間(yyyyMMddHH)(24小時制),精確到小時。
2.所有參數大小寫敏感。
請求地址:http://www.接口.com/api1.aspx
參數 | 類型 | 描述 | 是否必須 |
---|---|---|---|
a | int | 用戶標識,例如:108 | Y |
fun | string | 接口名稱,例如:GetGongShangByWord | Y |
c | string | 簽名,例如:1d0c8485f4e5e1f5406c8a4a4ccb968d | Y |
參數 | 類型 | 描述 | 是否必須 |
---|---|---|---|
data | json | 接口具體返回內容 | Y |
state | int | 請求接口狀態 | Y |
msg | string | 附加消息,無實際意義 | Y |
簡稱/術語 | 對應參數 | 說明 |
---|---|---|
apiID | a | 接口ID,調用接口時用于鑒權 |
apikey | apikey | 接口Key,調用接口時用于鑒權 |
加簽 | c | 根據指定的簽名規則,為報文設置簽名 |
狀態碼 | 說明 |
---|---|
-101 | 未知 |
-2** | 無權限 |
-201 | 賬號不存在 |
-202 | 用戶調用接口權限已過期 |
-203 | 無調用接口權限 |
-3** | 上傳參數異常 |
-301 | 調用接口名無效 |
-302 | 缺少參數 |
-303 | 參數錯誤 |
-304 | 簽名有誤 |