新增店铺

概述

本接口提供游戏类店铺的注册服务,支持以下核心功能:

  • 店铺标识管理
  • 接收店铺名称或系统生成的唯一标识符(二选一)
  • 当不便提供店铺名时,可提供10位大小写字母+数字混合的随机字符串(如7Hx9q2P4eR)
  • 严格校验标识符唯一性(防止冲突)
  • 要求客户端先通过查询游戏信息接口验证包名有效性
  • 只接受已通过验证的Android包名数组
  • 自动拒绝包含未验证包名的请求

接口地址

http://api.xvista.cc:9999/largespace/public/v1/add/store

请求方法

  • POST

请求参数

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 包名不存在:[发生异常的包名] 传入的部分包名不正确,请使用查询游戏信息接口获取所有可用包名

通用异常可以在“通用说明-统一异常处理”中找到说明

备注

  • 暂无
Copyright & www.xvista.cc 2025 all right reserved,powered by Gitbook该文件修订时间: 2025-06-17 03:21:28

results matching ""

    No results matching ""