接口開放平臺

接入流程

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	簽名有誤