Commit 2276ab36fc03eda7d271b67147f8bb5b825745e3
1 parent
038f1b0438
Exists in
master
fix code
Showing 1 changed file with 17 additions and 22 deletions Inline Diff
ServerDocument.md
| 1 | ## GumpTech服务端接口文档 | 1 | ## GumpTech服务端接口文档 |
| 2 | 2 | ||
| 3 | 1. 用户登录验证接口 | 3 | 1. 用户登录验证接口 |
| 4 | ---------------------------- | 4 | ---------------------------- |
| 5 | 接口地址:http://sdk.letsgame.mobi/v1/user/verify_user.do | 5 | 接口地址:http://sdk.letsgame.mobi/v1/user/verify_user.do |
| 6 | 参数: | 6 | 参数: |
| 7 | appId: 游戏接入分配appid | 7 | appId: 游戏接入分配appid |
| 8 | appkey: 注意appkey都为小写字母 | 8 | appkey: 注意appkey都为小写字母 |
| 9 | userId: GumpTech平台的用户id | 9 | userId: GumpTech平台的用户id |
| 10 | sessionKey: 登录后回调给给第三方 | 10 | sessionKey: 登录后回调给给第三方 |
| 11 | 11 | ||
| 12 | 返回值: | 12 | 返回值: |
| 13 | { | 13 | { |
| 14 | "code":100000 | 14 | "code":100000 |
| 15 | "msg":"xxxxxx" | 15 | "msg":"xxxxxx" |
| 16 | "data":{ | 16 | "data":{ |
| 17 | "userId":23444 | 17 | "userId":23444 |
| 18 | "sessionKey":"xxx" | 18 | "sessionKey":"xxx" |
| 19 | } | 19 | } |
| 20 | } | 20 | } |
| 21 | 21 | ||
| 22 | 22 | ||
| 23 | 23 | ||
| 24 | 2. 充值通知第三方服务端接口 | 24 | 2. 充值通知第三方服务端接口 |
| 25 | ----------------------------- | 25 | ----------------------------- |
| 26 | 参数列表: | 26 | 参数列表: |
| 27 | orderId: 订单id | 27 | orderId: 订单id |
| 28 | appId: 游戏接入分配appid | 28 | appId: 游戏接入分配appid |
| 29 | userId: 平台用户id | 29 | userId: 平台用户id |
| 30 | product: 购买商品名字 | 30 | product: 购买商品名字 |
| 31 | extraInfo:游戏接入方传入自定义参数,200字符,页面支付值为:web_pay:[serverId]_[roleName] | 31 | extraInfo:游戏接入方传入自定义参数,200字符,页面支付值为:web_pay:[serverId]_[roleName] |
| 32 | currency:币种 exp:USD RMB | 32 | currency:币种 exp:USD RMB |
| 33 | amount:支付过程中选中额度,第三方可以忽略此参数 | 33 | amount:支付过程中选中额度,第三方可以忽略此参数 |
| 34 | realAmount: 最终用户支付的额度 | 34 | realAmount: 最终用户支付的额度 |
| 35 | sig: 签名 | 35 | sig: 签名 |
| 36 | 36 | ||
| 37 | 第三方server端返回值: | 37 | 第三方server端返回值: |
| 38 | 如果第三方验证成功,则返回字符串:success即可。 | 38 | 如果第三方验证成功,则返回字符串:success即可。 |
| 39 | 39 | ||
| 40 | 40 | ||
| 41 | 3.签名算法 | 41 | 3.签名算法 |
| 42 | -------------------------------- | 42 | -------------------------------- |
| 43 | 43 | ||
| 44 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 | 44 | 注意:签名参数不能写成固定数量,一定要获取全部参数并且除sig参数外,然后按照字母升序排列。 |
| 45 | ```java | 45 | ```java |
| 46 | 46 | ||
| 47 | /** | 47 | /** |
| 48 | * 签名算法 | 48 | * 签名算法 |
| 49 | * @param userOrder | 49 | * @param request |
| 50 | * @param key | ||
| 51 | * @return | 50 | * @return |
| 52 | */ | 51 | */ |
| 53 | private String sig(UserOrder userOrder, String key) { | 52 | public String sig(HttpServletRequest request){ |
| 54 | 53 | ||
| 54 | Enumeration names = request.getParameterNames(); | ||
| 55 | SortedSet<String> allParams = Sets.newTreeSet(); | 55 | SortedSet<String> allParams = Sets.newTreeSet(); |
| 56 | try { | 56 | |
| 57 | 57 | while (names.hasMoreElements()) { | |
| 58 | allParams.add(Constants.Keys.ORDER_ID + "=" + URLEncoder.encode(userOrder.getId()+"", "utf-8")); | 58 | String name = (String) names.nextElement(); |
| 59 | allParams.add(Constants.Keys.APPID + "=" + URLEncoder.encode(userOrder.getAppId()+"", "utf-8")); | 59 | if (name.equals("sig")) { |
| 60 | allParams.add(Constants.Keys.USER_ID + "=" + URLEncoder.encode(userOrder.getUserId()+"", "utf-8")); | 60 | continue; |
| 61 | allParams.add(Constants.Keys.PRODUCT + "=" + URLEncoder.encode(userOrder.getProduct(), "utf-8")); | 61 | } |
| 62 | 62 | ||
| 63 | allParams.add(Constants.Keys.EXTRA_INFO + "=" + URLEncoder.encode(userOrder.getExtraInfo(), "utf-8")); | 63 | try { |
| 64 | allParams.add(Constants.Keys.CURRENCY + "=" + URLEncoder.encode(userOrder.getCurrency(), "utf-8")); | 64 | allParams.add(name + "=" + UriUtils.decode(request.getParameter(name), "utf-8")); |
| 65 | allParams.add(Constants.Keys.AMOUNT + "=" + URLEncoder.encode(userOrder.getAmount()+"", "utf-8")); | 65 | } catch (UnsupportedEncodingException e) { |
| 66 | allParams.add(Constants.Keys.REAL_AMOUNT + "=" + URLEncoder.encode(userOrder.getRealAmount()+"", "utf-8")); | 66 | e.printStackTrace(); |
| 67 | 67 | } | |
| 68 | } catch (UnsupportedEncodingException e) { | ||
| 69 | e.printStackTrace(); | ||
| 70 | } | 68 | } |
| 71 | 69 | String computedToken = DigestUtils.md5DigestAsHex(Joiner.on("&").join(allParams).getBytes()); | |
| 72 | String params = Joiner.on("&").join(allParams) + key; | ||
| 73 | log.info("sig:" + params); | ||
| 74 | String computedToken = DigestUtils.md5DigestAsHex(params.getBytes()); | ||
| 75 | return computedToken; | 70 | return computedToken; |
| 76 | } | 71 | } |
| 77 | ``` | 72 | ``` |
| 78 | 注意:参数是按字母升序排列 | 73 | 注意:参数是按字母升序排列 |
| 79 | 74 | ||
| 80 | 75 | ||
| 81 | 4. 错误码对照表 | 76 | 4. 错误码对照表 |
| 82 | ----------------------------- | 77 | ----------------------------- |
| 83 | 78 | ||
| 84 | 100000 : 成功 | 79 | 100000 : 成功 |
| 85 | 800000 : 应用不存在 | 80 | 800000 : 应用不存在 |
| 86 | 100010 : 用户密码错误 | 81 | 100010 : 用户密码错误 |
| 87 | 100011 : 用户已经存在 | 82 | 100011 : 用户已经存在 |
| 88 | 100012 : 用户不存在 | 83 | 100012 : 用户不存在 |
| 89 | 100013 : 用户名不能为空 | 84 | 100013 : 用户名不能为空 |
| 90 | 900000 : 订单不存在 | 85 | 900000 : 订单不存在 |
| 91 | 900001 : 支付失败 | 86 | 900001 : 支付失败 |