罗马-免SDK-红包版API-给CP

免SDK-CP对接


2.1 角色上报(必接)

简要描述:

  • CP方需在玩家创建角色后、或登录设备变更后,在后端调用此接口,其中角色ID、设备ID将作为后续查询用户奖励的关键依据。

调用时机:

  • 1.首次创建角色后;
  • 2.登录设备变更后;

请求URL:

  • /api/cp/v1/init

请求方式:

  • POST

Content-Type

  • application/json;charset=UTF-8

参数示例:

参数名 必选 类型 说明
cpId string CP公司ID(固定值,CP公司在我方的唯一标识)
gameId string CP公司游戏ID(若没有则由我方指定)
account string 玩家登录账号
roleId string 角色唯一标识
serverId string 区服ID,默认:1
deviceId string 设备ID/广告追踪ID<br/>非常重要,用于首次追踪玩家账号
osType string 系统类型:android/ios
osVer string 系统版本号,如:9_28
model string 手机型号,如:PBBM00
sign string 签名,参考《签名算法》

返回参数:

参数名 必选 类型 说明
code string 错误码
msg string 错误描述

成功返回示例:

{
    &quot;code&quot;: &quot;00000&quot;,
    &quot;msg&quot;: &quot;success&quot;
}

失败返回示例:

{
    &quot;code&quot;: &quot;30000&quot;,
    &quot;msg&quot;: &quot;Request Params Error.&quot;
}

页面列表

ITEM_HTML