H5JSSDK后端接口文档(小游戏)

概述1.
1接口调用方式通过http协议,将要接口需要的参数,GET方式传递.
1.
2接口地址URL(IDC可以使用CL5方式访问[64069121:43122688])http[s]://h5sdk.
game.
qq.
com/api2/H5SDKApi.
phpapptype=4&appid={appId}&methodCmd={methodCmd}测试环境:IDC内网调用10.
239.
216.
210:9508外网环境GET参数增加env=test1.
3接口Url通用参数参数说明:apptype:必填参数,平台类型,4代表微信小游戏;methodCmd:必填参数,方法编号,1037代表qq平台未注册密友;appid:必填参数,指小游戏的appid;h5game_openid:用户openid;h5sdk_sessionid:用户用户登录的sessionId;callback:可选参数,如果需要跨域请求,请用jsonp方式;h5game_reqtime:可选参数,请求的时间戳,与服务器时间差超过120秒视为无效请求;h5game_sign:可选参数,请求签名,签名方式参考1.
51.
4返回类型默认返回json,如果需要jsonp,请增加callback参数iRet:0表示成功,非0表示失败sMsg:提示信息,如果出错,会提示具体错误信息list:返回的数据内容,如果无内容,返回空数组serialNo:当前请求的日志流水号errFrom:返回具体错误信息来源,出错会显示该字段1.
5签名计算方式h5game_sign=md5(h5game_openid+h5game_reqtime+app_secret)接口列表2.
7获取游戏accessToken与用户session_key(用户登录态有效)接口:methodCmd=10452.
7.
1请求参数列表(需加上通用参数):参数名参数意义是否必填传递方式h5game_openid用户openid否geth5sdk_sessionid当前会话id否geth5game_reqtime请求时间戳是geth5game_sign签名Md5(h5game_openid+h5game_reqtime+appsecret)是getisRefresh是否强制刷新accesstoken,0不刷新,1强制刷新否getgtkOption是否返回游戏accesstoken,0返回该选项,1不返回该选项否get2.
7.
2响应参数:参数名参数意义备注iRet0成功,非0代表失败0代表成功,非0代表失败sMsg返回消息,成功success成功或者失败返回具体消息list返回Json对象list.
access_token游戏的access_tokenlist.
session_key玩家的session_keyserialNoAMS平台日志流水号errFrom错误来源2.
7.
3调用实例:curl"http://h5sdk.
game.
qq.
com/api2/H5SDKApi.
phpapptype=4&appid=wxc8a63fdcb48265f4&methodCmd=1045&h5game_openid=oXUwi0XoFi7HkxoUOOQ7QcySSewI&h5sdk_sessionid=34A3327C04BF4A0612BCAB0134D7CCB7&h5game_reqtime=xxx&h5game_sign=xxx"//返回结果{"iRet":0,"sMsg":"success","list":{"session_key":"xxxxx","access_token":"xxxxxx"},"serialNo":"[AMS-H5_MSDKH5Demo-1127174006-fEXaGK-3627-1045]"}2.
7.
4备注1.
如果存在用户登录态信息(h5game_openid&h5sdk_sessionid),该接口会校验用户登录态,如果登录态合法,会返回用户的session_key.
2.
由于获取游戏accesstoken有限频,80次/小时,调用该接口isRefresh默认不要设置成1,只有当接口错误码是40001,错误消息是invalidcredential,access_tokenisinvalidornotlatest后,调用方可以增加重试,此时isRefresh设置成1.
3.
三种场景说明:(1).
只需要游戏accesstoken,接口不传递用户登录态信息(不传递h5game_openid和h5sdk_sessionid参数);(2).
只需要玩家session_key,接口需要用户登录态信息(h5game_openid和h5sdk_sessionid),且参数gtkOption=1;(3).
同时返回游戏accesstoken和玩家session_key,接口需要用户登录态信息(h5game_openid和h5sdk_sessionid),且参数gtkOption=0或者不传递该参数;