1. 描述

创建店铺。 登录用户都可以创建店铺,但一家店铺只能属于一家用户。只有在户群平台登录，获取红令牌后，就可以以角色none创建店铺。店铺创建必须只能自己创建自己的，不能替别人创建。

2. 调用场景

开发者

  1. 登录http://consoler.{zond_id}.xdua.com后,
  2. 查看自己的企业列表，点击进入某个企业.
  3. 点击创建店铺使用Zoon角色创建自己的店铺

[!note|label:支持直接创建直属店铺] 很多用户开店，开1个店，两个店，3个店，有两种方法，一种是挂在社区直辖企业ID下，一种是替开发者自动创建一个虚拟的企业。目前还没有想好使用哪个方法，先严谨的要求客户必须创建企业。

3. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name AddShop
Url https://api.xdua.com/shop
Method POST
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod ADD
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 需要登录
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam name
XduaApiAction CreateShop
XduaApiRule CreateShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

4. 请求参数

名称 位置 类型 必填 默认值 示例 说明
avatar body string 否 店铺图标，不超过40个字符。
brief body string 否 店铺简介，不超过64个字符。
code body string 是 12100000400012342E 营业执照号
name body string 是 中国科学院计算技术研究所 店铺的名称。必须与营业执照一致。

[!note] 店铺创建时遵从简单第一步原则，创建只需要店铺名和店铺执照号两个属性就可以创建店铺。剩下通过setshop来完善。

5. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 创建的店铺ID

6. 错误码

7. 描述

删除店铺。

8. 调用场景

超级管理员Super用户在http://consoler.{zond_id}.xdua.com登录，系统自动指导它是Super, Super查询所有处于软删除状态的店铺。然后删除选中的。这个权限不给Admin，是因为这个是权限非常高的操作，它会让所有资源消失。。

9. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DelShop
URL https://api.xdua.com/shop
Method DELETE
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DEL
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有资源创建者自己可以访问这个口
XduaApiRoles Super 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction DeleteShop
XduaApiRule DeleteShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

10. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

11. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

12. 错误码

13. 描述

关闭店铺。

14. 调用场景

神管理员登录http://consoler.{zond_id}.xdua.com后,可以关闭普通开发者的店铺。使得店铺进入DISABLED状态，也只有Ceo角色重新打开这个店铺。

15. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DisShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DIS
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 必须是创建者才可以自闭店铺
XduaApiRoles Ceo 只有神级管理员才可以关闭普通开发者的店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction DisableShop
XduaApiRule DisableShop
XduaApiAstates 0,0 或者0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

16. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

17. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

18. 错误码

19. 描述

软删店铺。

20. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以点击自己的店铺，然后删除掉。如果哪天后悔了，可以联系Ceo来恢复。

21. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DolShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DOL
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有创建者自己才能删除自己创建的店铺
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction DeletoShop
XduaApiRule DeletoShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

22. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

23. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

24. 错误码

25. 描述

打开店铺。

26. 调用场景

管理员（Admin）

  1. 登录http://consoler.{zond_id}.xdua.com后,
  2. 根据条件查询店铺，条件是某个被关闭的店铺。
  3. 点击解冻，可以使能店铺。

27. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name EnbShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod ENB
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 神登录后解冻开发者的店铺
XduaApiRoles Ceo 只有神才可以解冻店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction EnableShop
XduaApiRule EnableShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

28. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

29. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

30. 错误码

31. 描述

详情店铺。

32. 调用场景

管理员登录http://consoler.{zond_id}.xdua.com后,可以随意查询能看见的所有店铺列表。点击其中一个店铺（不管是不是自己的），就可以点击访问。

33. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/shop
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod GET
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u !表示除了允许匿名用户之外的所有用户访问
XduaApiRoles Ceo 只要Ceo才可以访问其它用户的店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction GetShop
XduaApiRule GetShop
XduaApiShopAstate 0 令牌shop.state必须是0(STATE_ENABLED)
XduaApiCorpAstate 0 令牌corp.state必须是0(STATE_ENABLED)
XduaApiShopAstate 0 令牌shop.state必须是0(STATE_ENABLED)
XduaApiUserAstate 0 令牌user.state必须是0(STATE_ENABLED)
XduaApiAppAstate 0 令牌 app.state必须是0(STATE_ENABLED)
XduaApiTokenAstate 0 令牌token.state必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

34. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要修改的店铺ID

35. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 详情的店铺ID
name result.data string 店铺的名称
avatar result.data string 店铺图标
brief result.data string 店铺的描述
state result.data int 1 店铺的状态
stato result.data string "冻服更新" 店铺的状态说明
expire result.data int 0 店铺状态过期时间(UNIX时间戳)
creator_id result.list[] string Dmtv7TrE 店铺创建者ID
creator_name result.list[] string 辣椒帅 店铺创建者名字
updator_id result.list[] string XiyRvUp3 店铺最近一次更新者ID
updator_name result.list[] string 周海潮 店铺最近一次更新者名字
cstamp result.data string 2020-01-20 02:19:55 店铺创建时间
ustamp result.data string 2020-01-20 02:23:24 店铺最近更新时间

返回示例

result部分

{
    "id":"rYub4wrT",
    "data": {


    },
}

36. 错误码

37. 描述

私详店铺。

38. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,在店铺列表，选择店铺，点击详情，就可以查看自己的店铺。GIT的默认字段和GET不一样。

39. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/shop
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod GIT
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有自己才可以访问自己创建的店铺
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction GetShop
XduaApiRule GetShop
XduaApiShopAstate 0 令牌shop.state必须是0(STATE_ENABLED)
XduaApiCorpAstate 0 令牌corp.state必须是0(STATE_ENABLED)
XduaApiShopAstate 0 令牌shop.state必须是0(STATE_ENABLED)
XduaApiUserAstate 0 令牌user.state必须是0(STATE_ENABLED)
XduaApiAppAstate 0 令牌 app.state必须是0(STATE_ENABLED)
XduaApiTokenAstate 0 令牌token.state必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

40. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要修改的店铺ID

41. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 详情的店铺ID
name result.data string 店铺的名称
avatar result.data string 店铺图标
brief result.data string 店铺的描述
state result.data int 1 店铺的状态
stato result.data string "冻服更新" 店铺的状态说明
expire result.data int 0 店铺状态过期时间(UNIX时间戳)
creator_id result.list[] string Dmtv7TrE 店铺创建者ID
creator_name result.list[] string 辣椒帅 店铺创建者名字
updator_id result.list[] string XiyRvUp3 店铺最近一次更新者ID
updator_name result.list[] string 周海潮 店铺最近一次更新者名字
cstamp result.data string 2020-01-20 02:19:55 店铺创建时间
ustamp result.data string 2020-01-20 02:23:24 店铺最近更新时间

返回示例

result部分

{
    "id":"rYub4wrT",
    "data": {


    },
}

42. 错误码

43. 描述

下线店铺。

44. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以下线自己创建的店铺。

45. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name OffShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod OFF
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只能店铺的创建者才能下线自己的店铺
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction OfflineShop
XduaApiRule OfflineShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

46. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

47. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

48. 错误码

49. 描述

发布店铺。

50. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以下线/发布自己的店铺。这个动作是管理员不能干涉的。

51. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name PubShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod PUB
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有店铺的创建者自己才能上下线自己的店铺
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction OnlineShop
XduaApiRule OnlineShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

52. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

53. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

54. 错误码

55. 描述

私查店铺。

56. 调用场景

开发者登录http://consoler.xdua.com后,可以以Ceo角色查询所有店铺。

57. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name QriShop
URL https://api.xdua.com/shop
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod QRI
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 所有注册用户均可以使用
XduaApiRoles Ceo 必须是Ceo才可以查询角色
XduaApiResource shop
XduaApiKparam where 常量
XduaApiAction QueriShop
XduaApiRule QueriShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

58. URL

GET:https://api.xdua.com/shop

59. 请求参数

参考标准查询接口请求参数

60. 返回参数

参考标准查询接口返回参数

result.list部分

名称 位置 类型 示例 说明
id result string rYub4wrT 详情的店铺ID
name result.list[] string 店铺的名称
avatar result.list[] string 店铺图标
brief result.list[] string 店铺的描述
state result.list[] int 0 店铺的状态
stato result.list[] string "冻服更新" 店铺的状态说
expire result.list[] int 0 店铺状态过期时间(UNIX时间戳)
creator_id result.list[] string Dmtv7TrE 店铺创建者ID
creator_name result.list[] string 辣椒帅 店铺创建者名字
updator_id result.list[] string XiyRvUp3 店铺最近一次更新者ID
updator_name result.list[] string 周海潮 店铺最近一次更新者名字
cstamp result.list[] string 2020-01-20 02:19:55 店铺创建时间
ustamp result.list[] string 2020-01-20 02:23:24 店铺最近更新时间

61. 错误码

62. 描述

查询店铺。

63. 调用场景

开发者登录http://consoler.xdua.com后,可以以Zoon角色查询属于自己名下的所有店铺。

64. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name QryShop
URL https://api.xdua.com/shop
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod QRY
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 所有注册用户均可以使用
XduaApiRoles Ceo 必须是Ceo才可以查询角色
XduaApiResource shop
XduaApiKparam where 常量where
XduaApiAction QueryShop
XduaApiRule QueryShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

65. URL

GET:https://api.xdua.com/shop

66. 请求参数

参考标准查询接口请求参数

67. 返回参数

参考标准查询接口返回参数

result.list部分

名称 位置 类型 示例 说明
id result string rYub4wrT 详情的店铺ID
name result.list[] string 店铺的名称
avatar result.list[] string 店铺图标
brief result.list[] string 店铺的描述
state result.list[] int 0 店铺的状态
stato result.list[] string "冻服更新" 店铺的状态说
expire result.list[] int 0 店铺状态过期时间(UNIX时间戳)
creator_id result.list[] string Dmtv7TrE 店铺创建者ID
creator_name result.list[] string 辣椒帅 店铺创建者名字
updator_id result.list[] string XiyRvUp3 店铺最近一次更新者ID
updator_name result.list[] string 周海潮 店铺最近一次更新者名字
cstamp result.list[] string 2020-01-20 02:19:55 店铺创建时间
ustamp result.list[] string 2020-01-20 02:23:24 店铺最近更新时间

68. 错误码

69. 描述

回收店铺。

70. 调用场景

管理员应开发者的要求，登录http://consoler.{zond_id}.xdua.com后,查询到某个开发者下面的被删除的店铺。然后回收。开发者刷新就可以看到了。为此，开发者要提供自己的uid和要回收的店铺的名字。

71. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name RccShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod RCC
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u u表示除了允许匿名用户之外的所有用户访问
XduaApiRoles Ceo 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction RecycleShop
XduaApiRule RecycleShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

72. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要删除的店铺ID

73. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 删除的店铺ID

74. 错误码

75. 描述

修改店铺。

76. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以修改自己创建的店铺。修改仅仅限于可以修改的name,brief等字段。

77. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name SetShop
URL https://api.xdua.com/shop
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod SET
XduaApiColor X 只有持有神令牌，才可以创建店铺
XduaApiAudience {shop_console_app_id} 只有app_id为{shop_console_app_id}的应用，也就是consoler.{zond_id}.xdua.com才可以发起本请求
XduaApiShop {corp_id} 店铺直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i i,只有创建者自己才可以修改
XduaApiRoles Zoon 只要登录就可以创建店铺
XduaApiResource shop
XduaApiKparam id
XduaApiAction UpdateShop
XduaApiRule UpdateShop
XduaApiAstates 0 按序app,shop,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

78. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要修改的店铺ID
name body string 否 店铺的名称，必须唯一，支持汉字、英文字母、数字、英文格式的下划线，必须以英文字母或汉字开头，4~32个字符
avatar body string 否 店铺图标，不超过40个字符。
brief body string 否 店铺描述，不超过64个字符。

79. 返回参数

名称 位置 类型 示例 说明
id result string rYub4wrT 修改的店铺ID
updates result json dict 修改的内容

示例

result字段

{
    "id":"rYub4wrT",
    "updates":{
        "name":"新的店铺名",
        "brief":"新的店铺介绍",    
    }    
}

80. 错误码

results matching ""

    No results matching ""