PCSDK 服务端接口说明

1.登录请求

1.1请求URL：

  • CP提供

1.2请求方式：

  • POST

1.3参数携带方式：

  • application/json

1.4请求体参数：

参数名 必选 类型 说明
clientIp 是 String 客户端ip
channel 是 String 打点标记，jsonstr
gameId 是 int 游戏id
platform 是 int 固定 9
userId 是 String ULU uid，唯一
token 是 String ULU token
extraData 是 String web页接收的透传参数，没有传""
timestamp 是 long 时间，精确到毫秒
signature 是 String 签名， sign签名算法：根据参数名称a-z排序，将参数值拼接后+ secret(密钥) finalString，在进行md5（）加密，例如：md5（channel+clientIp+extraData+…+uid+secret）。

1.5请求示例：

{
    "clientIp": "128.1.125.51",
    "channel": "{\"key\":value,\"key\":\"value\"}",
    "gameId": 100281,
    "platform": 9,
    "userId":"1461229553388138497",
    "token":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ7",
    "extraData":"",
    "timestamp":1655889609000,
    "signature":"2f57b7fcd12c86ba93803fd56104e8db"
}

1.6返回参数说明

参数名 类型 说明
code int 状态码:0为成功,其他为失败的错误码
context String JsonStr，包含key，value，
url String web页需要请求的url
desc String 响应描述，成功返回SUCCESS,失败返回失败原因。

1.7成功返回示例

{
    "code":0,
    "context":[
        {
            "key":"resource", "value":"sgdts_w_kr_d_w_beta"
        },{
            "key":"account","value":"1210086437446320129"
        },{
            "key":"token","value":"7EF83554E7CF410F8A1D1B2F948A91D3"
        },{
  "key":"SDKToken","value":"eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ7XCJnYW1lSWRcIjoxMDAxNjAsXCJ1aWRcIjpcIjEyMTAwODY0Mzc0NDYzMjAxMjlcIixcImxhbmd1YWdlXCI6XCJrby1LUlwiLFwidXNlck5hbWVcIjpcImdvb2dsZVwiLFwiY2hhbm5lbElkXCI6OSxcInBsYXRmb3JtXCI6MyxcInRva2VuXCI6XCJ0b2tlblwifSIsImdhbWVJZCI6MTAwMTYwLCJ1aWQiOiIxMjEwMDg2NDM3NDQ2MzIwMTI5IiwibGFuZ3VhZ2UiOiJrby1LUiIsImNoYW5uZWxJZCI6OSwicGxhdGZvcm0iOjMsImV4cCI6MTY3OTQ3MDU3OX0.aaO3I7FzOuQ5nnPX1xuCGSTQYRUrk3_y_pFEreu4Ugj2ODDnCJ-zT7Na6BOSciubxSLudfcbIoapaPGM5WH1aw"
        },{
            "key":"channel","value":"google"
          }
    ],
    "url":"https://sgdts_center.ulugame.com/gateway/login_safety","desc":"success",
    "desc":"SUCCESS"
}

1.8失败返回示例

 {
     "code": 1,
     "desc":"error happen"
     }

2. 发货请求

2.1请求URL：

  • CP方提供

2.2请求方式：

  • POST

2.3支持方式：

  • application/json

2.4参数：

参数名 必选 类型 示例 说明
productId 是 str(50) "ulu_product_01" 玩家购买的内购项id
serverId 是 str(255) "2" 服务器id，cp传入
roleId 是 str(255) "137" 角色id，cp传入
orderNo 是 str(100) "MYCARD1544990963624099842" 订单id 平台 支付id 唯一（可用来判断重复发送凭证）
channelReceipt 是 str(100) "MYCARD1544990963624099842" 付费渠道提供的订单号
gameId 是 int(10) 100160 购买道具的游戏id
uid 是 str(50) "1544990909915996161" 购买道具的用户id
payChannel 是 int(20) 16 付费渠道id
currency 是 str(20) "TWD" 用户支付币种
amount 是 str(20) "33" 用户支付金额
areaAmount 是 str(20) "33" 内购金额
areaCurrency 是 str(20) "TWD" 内购币种
sandbox 是 int(1) 1 支付环境代号，1沙盒；0 生产
extraData 是 str(500) "透传参数" 游戏下单时cp传递的扩展参数，将原样返回
payTime 是 int(20) 1658415600000 购买时间，时间戳格式，精确到毫秒值
signature 是 Str "2f57b7fcd12c86ba93803fd56104e8db" 签名:根据参数名称a-z排序(signature不参与加密)，将参数值拼接后+ secret（密钥） 得到finalString ，在进行md5（）小写加密，例如：md5（amount+channelReceipt+currency+...+uid+secret）小写

2.5请求示例

{
    "productId":"ulu_product_01",
    "serverId":"ss2",
    "roleId":"rr1",
    "orderNo":"MYCARD1544990963624099842",
    "channelReceipt":"MYCARD1544990963624099842",
    "gameId":100160,
    "uid":1544990909915996161,
    "payChannel":16,
    "currency":"TWD",
    "amount":"33",
    "areaAmount":"33",
    "areaCurrency":"TWD",
    "sandbox":1,
    "extraData":"透传参数",
    "payTime":1658415600000,
    "signture":"2f57b7fcd12c86ba93803fd56104e8db"
}

2.6返回示例

成功示例

{
    "code": 0，
    "message":"SUCCESS"
 }

失败示例

{
    "code": 500，
    "message":"roleId does not exist"
 }

2.7返回参数说明

参数名 必传 类型 说明 示例
code 是 int 成功返回：0，失败返回失败码。 0
message 是 string 成功返回"SUCCESS",失败返回失败原因 "SUCCESS"

results matching ""

    No results matching ""