新增店铺
概述
本接口提供游戏类店铺的注册服务,支持以下核心功能:
- 店铺标识管理
- 接收店铺名称或系统生成的唯一标识符(二选一)
- 当不便提供店铺名时,可提供10位大小写字母+数字混合的随机字符串(如7Hx9q2P4eR)
- 严格校验标识符唯一性(防止冲突)
- 要求客户端先通过查询游戏信息接口验证包名有效性
- 只接受已通过验证的Android包名数组
- 自动拒绝包含未验证包名的请求
接口地址
http://api.xvista.cc:9999/largespace/public/v1/add/store
请求方法
请求参数
url参数:
http://api.xvista.cc:9999/largespace/public/v1/add/store?access_token=00000000000000
| 参数 |
必选 |
值 |
| access_token |
是 |
通过Secret Key获取的access_token,参考"获取access_token" |
Body参数:
{
"name" : "test store1",
"game" : [
"com.xx.abc",
"com.xx.123"
],
"notes" : ""
}
| 参数 |
必选 |
类型 |
值 |
| name |
是 |
string |
店铺名称 |
| game |
是 |
string集合 |
游戏安卓包名 |
| notes |
是 |
string |
备注 |
返回示例
成功返回:
{
"code": 1,
"message": "success",
"data": {
"store_id": "000000"
},
"timestamp": 1750092859409,
"executeTime": 156
}
| 参数 |
类型 |
值 |
| client_id |
string |
生成的店铺ID |
除"data"外的其他参数,可以在“通用说明-统一请求响应”中找到说明
错误返回:
| code |
message |
解释 |
| 400 |
项目名冲突 |
名下已存在相同名称店铺 |
| 400 |
包名不存在:[发生异常的包名] |
传入的部分包名不正确,请使用查询游戏信息接口获取所有可用包名 |
通用异常可以在“通用说明-统一异常处理”中找到说明
备注