服务端

1 通过游戏大厅Token获取用户信息

CP登录小游戏大厅后，小游戏大厅会返回一个Token给CP，CP可以调用此接口获取其用户信息。

1.1 接口

https://play.open.oppomobile.com/instant-game-open/userInfo

1.2 请求方式

GET

1.3 URL请求参数

签名生成步骤：

（1）准备签名所需参数

pkgName(游戏包名)
appKey(游戏上架时分配的Key)
appSecret(游戏上架时分配的密钥)
token(登录时获得的token)
timeStamp(时间戳，毫秒，取当前时间值)

（2）将参数按照字典序排序,使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串

例如：

appKey=11&appSecret=22&pkgName=com.oppo.testgame&timeStamp=1526304757000&token=ccb5ae1cf111de847db508edb90fa633

（3）使用 md5 算法对构造的源串进行加密,将得到的字符串所有字符转换为大写

例如：

    C26228F50092BC9CA251AF41C4F70022

示例：

/instant-game-open/userInfo?pkgName=com.oppo.testgame&timeStamp=1526304757000&token=ccb5ae1cf111de847db508edb90fa633&sign=C26228F50092BC9CA251AF41C4F70022

1.4 响应消息

注意：出参为json字符串(如:{ "userInfo": "", "errorcode": "0", "errormsg": "ok" })

UserInfo信息如下：

示例：

    {
        "errorcode":200,
        "errormsg":"成功",
        "userInfo":
        {
            "userId":"2000060053",
            "userName":"183******85",
            "avatar":"http://cdopic0.oppomobile.com/play/201811/12/dff4c57b747f.jpg",
            "sex":"F",
            "location":"",
            "constellation":"",
            "age":18
        }
    }

1.5 错误码列表

2 排行榜数据更新接口信息

该接口的调用方必须是 cp 服务端

排行榜由开发者按照要求上报数据后，在OPPO小游戏相关场景展现的排行榜

2.1 接口

https://play.open.oppomobile.com/instant-game-open/rank/update

2.2 请求方式

POST

2.3 请求头

2.4 URL请求参数

rankScore来源要求和举例

上报的分数有2点要求：

1. 该分数可以衡量游戏核心目标的完成情况
2. 需要避免大量玩家并列排名的情况，可选择粒度较小的数值，或结合时间先后次序

举例：

1. “欢喜斗地主”中的金豆数量

2. “热血飞刀大战”的战力

3. “子弹先生狙击战场”的金钱数量

4. “贪吃蛇大作战”限时模式的当局分数

5. “斗罗大陆”的战力

6. “刀剑大作战”的当天最高击杀数

2.5 响应消息

2.6 错误码列表

签名生成

第一步，准备签名所需参数

pkgName(游戏包名)
appKey(游戏上架时分配的Key)
appSecret(游戏上架时分配的密钥)
userId(用户id)
rankScore(上报的分数)
rankType(排行榜类型)
timeStamp(时间戳)

第二步，将参数按照字典序排序,使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串

appKey=11&appSecret=22&pkgName=com.oppo.testgame&rankScore=333&rankType=0&timeStamp=15281&userId=1111111

注意 : 参数名区分大小写

第三步，使用 md5 算法对构造的源串进行加密,将得到的字符串所有字符转换为大写

F852521612103827E831175417C0276F

实例代码：

curl -H "Content-Type: application/x-www-form-urlencoded" -X POST  -v http://instantGame.game-test.wanyol.com/instant-game-open/rank/update -d "userId=2000060053&pkgName=com.lechang.leftright.kyx.nearme.gamecenter&rankType=0&rankScore=12&sign=BB20D131CDF4B0EA8D2128C829763C75&timeStamp=1556537240333"

签名参考代码：

package com.oppo.util;

import java.util.Iterator;
import java.util.Set;
import java.util.TreeMap;
import org.apache.commons.codec.digest.DigestUtils;

public class Example {
    public static String getSignContent() {

        TreeMap<String, String> signMap = new TreeMap<>();
        signMap.put("userId", userId);
        signMap.put("pkgName", pkgName);
        signMap.put("rankScore", rankScore);
        signMap.put("rankType", rankType);
        signMap.put("timeStamp", timeStamp);
        signMap.put("appKey", appKey);
        signMap.put("appSecret", appSecret);

        Set<String> keys = treeMap.keySet();
        StringBuilder sb = new StringBuilder();
        Iterator<String> iterator = keys.iterator();
        while (iterator.hasNext()) {
            String key = iterator.next();
            sb.append(key).append("=").append(treeMap.get(key)).append("&");
        }

        String signContent = sb.toString().substring(0, sb.length() - 1);

        return signContent;

    }

    public static String sign(String content) {
        String signString = DigestUtils.md5Hex(content).toUpperCase();
        return signString;
    }

    public static void main(String[] args) {
        String signContent = getSignContent();
        String sign = sign(signContent);
        System.out.println(sign);
    }
}