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 : 支付失败 |