# 一、同步游戏角色信息
提供给cp方,用于同步游戏角色。
## 1、请求地址
环境 | 请求地址
--- | -------
正式环境 | https://wogame.com/sdk/cp/api/synchronizeRoleInfo
## 2.1、请求head参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
WG-AppKey | String | 是 | 64 | appKey,由wogame平台分配 | 10001
## 2.2、请求body参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
roleId | String | 是 | 128 | 角色ID | 100671000064
roleName | String | 是 | 64 | 角色名称 | 浩瀚星空
roleServer | String | 否 | 128 | 角色区服 | 13-青光大阵
roleCamp | String | 否 | 64 | 角色阵营 | 天策
roleLevel | String | 否 | 32 | 角色等级 | 2
## 3、响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
code | String | 是 | 16 | 响应码 | 2000
message | String | 是 | / | 错误提示信息 | 角色同步失败
data | String | 是 | / | 处理是否成功 | true
## 4、请求示例
## 5、响应示例
# 二、根据openId查询用户信息接口
提供给cp方,用于验证openId的有效性。
## 1、请求地址
环境 | 请求地址
--- | -------
正式环境 | https://wogame.com/sdk/acp/api/getSdkUser
## 2.1、请求head参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
WG-AppKey | String | 是 | 64 | appKey,由wogame平台分配 | 10001
## 2.2、请求body参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
openId | String | 是 | 64 | openId | c0876cb19fdd7f537e1d91ac1a80dafd
## 3、响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
code | String | 是 | 16 | 响应码 | 2000
message | String | 是 | / | 错误提示信息 | openId非法
data |
userName | String | 是 | 30 | 用户名 | 城主
openId | String | 是 | 64 | openId | c0876cb19fdd7f537e1d91ac1a80dafd
gameId | String | 是 | / | 游戏ID | 1
## 4、请求示例
## 5、响应示例
# 三、根据订单编号查询订单信息接口
提供给cp方主动查询获取订单信息。可以根据系统平台订单ID,或CP方的订单ID,查询订单的交易状态、支付时间等详细信息。
## 1、请求地址
环境 | 请求地址
--- | ----
正式环境 | https://wogame.com/sdk/cp/api/getOrderInfo
## 2.1、请求head参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
WG-AppKey | String | 是 | 64 | appKey,由wogame平台分配 | 10001
## 2.2、请求body参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
orderId | String | 特殊可选 | 64 | 系统平台订单ID,和游戏商的订单ID不能同时为空。orderId,cpOrderId如果同时存在,优先取orderId | 1078555154298023938
outOrderId | String | 特殊可选 |64 | 游戏商的订单ID,和系统平台订单ID不能同时为空 | 1521108544151505
## 3、响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
code | String | 是 | 16 | 响应码 | 2000
message | String | 是 | / | 错误提示信息 | 订单不存在
data |
orderId | String | 是 | 64 | 系统平台订单ID | 1078555154298023938
outOrderId | String | 是 | 64 | 游戏商的订单ID | 1521108544151505
gameId | String | 是 | 64 | 游戏ID | 1
osType | Number | 是 | / | 操作系统:1-iOS,2-安卓 | 1
openId | String | 是 | 64 | openId | c0876cb19fdd7f537e1d91ac1a80dafd
orderStatus | Number | 是 | 交易状态:1-待付款,2-已付款,待处理,4-交易成功,5-交易失败,6-退款 | 4
orderPrice | Price | 是 | 交易金额, 单位:元,精确到小数点后两位 | 600.00
payWay | Number | 是 | 支付方式:1-支付宝;2-微信;4-IOS内支付;5-平台支付
payTime | String | 可选 | 支付时间,格式"yyyy-MM-dd HH:mm:ss",如果订单未支付,则为空 | 2019-01-24 13:07:53
## 4、请求示例
## 5、响应示例
# 一、游戏道具发货接口
系统平台作为调用方,游戏商cp作为服务方,在收到第三方支付回调通知说支付成功后,主动发送请求游戏道具发货。
## 1、请求地址
请求地址,取值为在创建游戏道具充值订单的时候的notifyUrl通知发货地址。
环境 | 请求地址
--- | -------
正式环境 |
## 2、请求参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
orderId | String | 是 | 64 | 系统平台订单ID | 1078555154298023938
outOrderId | String | 是 |64 | 游戏商的订单ID | 1521108544151505
openId | String | 是 | 64 | openId | c0876cb19fdd7f537e1d91ac1a80dafd
orderPrice | Price | 是 | 交易金额, 单位:元,精确到小数点后两位 | 600.00
extras | String | 否 | 透传参数 | cp方可以用此字段进行传递一些关键内容
notifyUrl | String | 是 | 200 | 通知发货地址 |
timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2019-01-24 13:07:53
sign | String | 是 | / | rsa2签名 | 详见“签名”
## 3、响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值
----| -----| ------- | ------ | ---- | -----
code | String | 是 | 16 | 响应码 | 2000
message | String | 是 | / | 错误提示信息 | 发货出现异常
data | String | 是 | / | 发货结果:ing(发货中);success(已发货) | success
## 4、请求示例
## 5、响应示例