接入流程

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 根據指定的簽名規則,為報文設置簽名

HTTP狀態碼一覽表:

狀態碼 說明
-101 未知
-2** 無權限
-201 賬號不存在
-202 用戶調用接口權限已過期
-203 無調用接口權限
-3** 上傳參數異常
-301 調用接口名無效
-302 缺少參數
-303 參數錯誤
-304 簽名有誤
财付通怎么买彩票