1. 描述
创建神角。
2. 调用场景
开发者登录超级控制台后,可以以Root神角创建自己的神角。
3. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | AddRolex | |
Url | https://api.xdua.com/rolex | |
Method | POST | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | ADD | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | 需要登录 |
XduaApiRoles | Root | Root可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | name | |
XduaApiAction | CreateRolex | |
XduaApiRule | CreateRolex | |
XduaApiAstates | 0 | |
XduaApiEnable | true | 接口使能 |
4. 请求参数
名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 说明 | |
---|---|---|---|---|---|---|---|
shop_id | body | String | 是 | 在哪个户群创建神角 | ugrp的代号 | ||
name | body | string | 是 | 健康手环 | 神角的名称,必须唯一,支持汉字、英文字母、数字、英文格式的下划线,必须以英文字母或汉字开头,4~32个字符 | ||
avatar | body | string | 否 | 神角图标,不超过40个字符。 | |||
brief | body | string | 否 | 神角描述,不超过64个字符。 | |||
code | body | string | 是 | Root | 神角的代号,16个字符以内,小写字母,数字和字母,不能有特殊符号,一旦创建,不可修改 | ||
granter | body | string | 是 | Root | 授权神角代号,code标准格式 |
5. 返回参数
名称 | 位置 | 类型 | 示例 | 说明 |
---|---|---|---|---|
id | result | string | rYub4wrT | 创建的神角ID |
6. 错误码
7. 描述
删除神角。
8. 调用场景
根用户在超级控制台登录. 它会让资源永久消失。。
9. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | DelRolex | |
URL | https://api.xdua.com/rolex | |
Method | DELETE | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | DEL | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | 只有资源创建者自己可以访问这个口 |
XduaApiRoles | Root | Root可以删除神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | DeleteRolex | |
XduaApiRule | DeleteRolex | |
XduaApiAstates | 0 | 按序app,zone,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. 调用场景
神管理员登录超级控制台后,可以关闭普通开发者的神角。使得神角进入DISABLED状态,也只有Root角色重新打开这个神角。
管理员(Root)
- 登录http://consoler.{zond_id}.xdua.com后,
- 根据条件查询神角,条件是某个神角。
- 点击
冻结
,可以关闭神角。
15. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | DisRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | DIS | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖神角,只有这个神角的登录人员才可以访问 |
XduaApiSubject | u | 必须是创建者才可以自闭神角 |
XduaApiRoles | Root | 只有神级管理员才可以关闭普通开发者的神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | DisableRolex | |
XduaApiRule | DisableRolex | |
XduaApiAstates | 0,0 或者0 |
按序app,zone,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. 调用场景
开发者登录超级控制台后,可以点击自己的神角,然后删除掉。如果哪天后悔了,可以联系Root来恢复。
21. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | DolRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | DOL | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | 只有创建者自己才能删除自己创建的神角 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | DeletoRolex | |
XduaApiRule | DeletoRolex | |
XduaApiAstates | 0 | 按序app,zone,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. 调用场景
管理员(Root)
- 登录http://consolex.xdua.com后,
- 根据条件查询神角,条件是某个被冻结的神角。
- 点击
解冻
,可以解冻店铺。
27. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | EnbRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | ENB | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | 神登录后解冻开发者的神角 |
XduaApiRoles | Root | 只有神才可以解冻神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | EnableRolex | |
XduaApiRule | EnableRolex | |
XduaApiAstates | 0 | 按序app,zone,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. 调用场景
管理员登录超级控制台后,可以随意查询能看见的所有神角列表。点击其中一个神角(不管是不是自己的),就可以点击访问。
33. 配置参数
参数名 | 参数值 | 说明 |
---|---|---|
URL | https://api.xdua.com/rolex | |
Method | GET | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | GET | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | !表示除了允许匿名用户之外的所有用户访问 |
XduaApiRoles | Root | 只要Root才可以访问其它用户的神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | GetRolex | |
XduaApiRule | GetRolex | |
XduaApiRolexAstate | 0 | 令牌zone.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. 调用场景
开发者登录超级控制台后,在神角列表,选择神角,点击详情,就可以查看自己的神角。GIT的默认字段和GET不一样。
39. 配置参数
参数名 | 参数值 | 说明 |
---|---|---|
URL | https://api.xdua.com/rolex | |
Method | GET | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | GIT | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | 只有自己才可以访问自己创建的神角 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | GetRolex | |
XduaApiRule | GetRolex | |
XduaApiRolexAstate | 0 | 令牌zone.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. 调用场景
开发者登录超级控制台后,可以下线自己创建的神角。
45. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | OffRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | OFF | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | 只能神角的创建者才能下线自己的神角 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | OfflineRolex | |
XduaApiRule | OfflineRolex | |
XduaApiAstates | 0 | 按序app,zone,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. 调用场景
开发者登录超级控制台后,可以下线/发布自己的神角。这个动作是管理员不能干涉的。
51. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | PubRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | PUB | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | 只有神角的创建者自己才能上下线自己的神角 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | OnlineRolex | |
XduaApiRule | OnlineRolex | |
XduaApiAstates | 0 | 按序app,zone,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://consolex.xdua.com后,可以以Root角色查询所有神角。
57. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | QriRolex | |
URL | https://api.xdua.com/rolex | |
Method | GET | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | QRI | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | 所有注册用户均可以使用 |
XduaApiRoles | Root | 必须是Root才可以查询角色 |
XduaApiResource | role | |
XduaApiKparam | where |
常量 |
XduaApiAction | QueriRolex | |
XduaApiRule | QueriRolex | |
XduaApiAstates | 0 | 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED) |
XduaApiEnable | true | 接口使能 |
58. URL
GET:https://api.xdua.com/rolex
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://consolex.xdua.com后,可以以Root角色查询属于自己名下的所有神角。
64. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | QryRolex | |
URL | https://api.xdua.com/rolex | |
Method | GET | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | QRY | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | 所有注册用户均可以使用 |
XduaApiRoles | Root | 必须是Root才可以查询角色 |
XduaApiResource | role | |
XduaApiKparam | where |
常量where |
XduaApiAction | QueryRolex | |
XduaApiRule | QueryRolex | |
XduaApiAstates | 0 | 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED) |
XduaApiEnable | true | 接口使能 |
65. URL
GET:https://api.xdua.com/rolex
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. 返回result
{
"limit": 20,
"total": 22,
"sort": {
"inc": "DESC"
},
"count": 20,
"page": 1,
"pages": 2,
"list": [{
"id": "BesterBe",
"cstamp": "2020-01-20 15:18:37",
"name": "B测官",
"state": 0,
"creator_name": "辣椒帅",
"code": "Bester",
"avatar": "http://avatar.xdua.com/role/default.png?x-oss-process=style/avatarp64",
"granter": "Butler",
"brief": "店铺测试官",
"creator_id": "Dt5mvrtU"
},{
"id": "NoneNone",
"cstamp": "2019-03-03 22:14:21",
"name": "民",
"state": 0,
"creator_name": "辣椒帅",
"code": "None",
"avatar": "http://avatar.xdua.com/role/defaultrolenone.png?x-oss-process=style/avatarp64",
"granter": "God",
"brief": "民",
"creator_id": "Dt5mvrtU"
}],
"format": "raw",
"where": {
"zone_id": "XdUaXduA",
"state": 0
},
"offset": 0
}
70. SDK调用
const XduaClient = require('../lib')
const xduaClient = await XduaClient({
LOGIN_TOKEN:"eyJhbGciOiJSUzI1NiIsImtpZCI6ImI1MGIxZWZmZGMwMzVlMjg2OWI2YzQ1ZjMzYmRmNWQ3In0.eyJpYXQiOjE1ODQ5NzUwNDMsIm5iZiI6MTU4NDk3NTA0MywiaXNzIjoieGR1YS5jb20iLCJleHAiOjE5MDAzMzUwNDMsImF1ZCI6IkJyb3dTZGtUIiwic3ViIjoiQW5vTnltdVMiLCJqdGkiOiIxMjM0NTY3OCIsImlwbSI6IioiLCJkdm0iOiIqIiwic2FwIjoiU3ZLZXJuZUwiLCJhcGkiOiJBZGRMb2dpbiIsImNsciI6IlgiLCJvd24iOiJEdDVtdnJ0VSIsInRpZCI6InhzQUZGNmpHIiwiYnVnIjoiREUiLCJsZ24iOiJOdWxsTnVsbCIsInR5cCI6IkwiLCJ0YWciOiJQcmltYXJ5Iiwiem9uZSI6IlhkVWFYZHVBIiwiY29ycCI6IlhkVWFYZHVBIiwic2hvcCI6IlhkVWFYZHVBIiwicm9sZSI6IioiLCJydWxlIjoiKiJ9.b_KQVug-D83hsfzHVoOvyJZUjjnWhr1UiRCLOBcUSFCLfh3ZoP5GE7m98s6H3QsDpYs20hFkFecj0xiyxzQKy5DOq9XbroXffDmBgg5y45WYnW3P8iqB2WQBtBwEU3VAWk_Vx6UwnGmpb_juu7KsFK33rWswFx3odbw7xe2iMdReywc6bYHf0P7s7kNYqYF_n-odiO6UsZd7yeNos8Hn7XtzE2igD7DhTbB0oxqEzVHoMtFcVAdstsLi3aAcJOK2Gp-XhWHSuiGqd9kTPmghk5cmIDcN7KOOZ6y1GQevM2Qc_7tfebP3Ev-bAZEPAyUA77zRrQMrpwJouejR_sNd3g",
})
const loginres = await xduaClient.addToginx({
ustr: '+86-15810419011',
pwd : 'a906449d5769fa7361d7ecc6aa3f6d28',
afs : "ignore"
})
//--------------------------------------------------
let api_name = "查询角色";
query = {
where:{state:0}
}
const res = await xduaClient.qryRolex(query);
console.log(res);
if(res.error == 0){
console.log(api_name+"成功 ");
}else{
console.log(api_name+"失败 "+res.reason);
}
71. 描述
回收神角。
72. 调用场景
管理员应开发者的要求,登录超级控制台后,查询到某个开发者下面的被删除的神角。然后回收。开发者刷新就可以看到了。为此,开发者要提供自己的uid和要回收的神角的名字。
73. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | RccRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | RCC | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | u | u表示除了允许匿名用户之外的所有用户访问 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | RecycleRolex | |
XduaApiRule | RecycleRolex | |
XduaApiAstates | 0 | 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED) |
XduaApiEnable | true | 接口使能 |
74. 请求参数
名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 说明 |
---|---|---|---|---|---|---|
id | path | string | 是 | rYub4wrT | 要删除的神角ID |
75. 返回参数
名称 | 位置 | 类型 | 示例 | 说明 |
---|---|---|---|---|
id | result | string | rYub4wrT | 删除的神角ID |
76. 错误码
77. 描述
修改神角。
78. 调用场景
开发者登录超级控制台后,可以修改自己创建的神角。修改仅仅限于可以修改的name,brief等字段。
79. 配置参数
参数意义参考接口参数
参数名 | 参数值 | 说明 |
---|---|---|
Name | SetRolex | |
URL | https://api.xdua.com/rolex | |
Method | PUT | |
XduaApiHttpSchema | HTTPS | 只走HTTPS |
XduaApiMethod | SET | |
XduaApiColor | X | 只有持有神令牌,才可以创建神角 |
XduaApiAudience | ConsoleX | 只有app_id为ConsoleX的应用,也就是consolex.xdua.com才可以发起本请求 |
XduaApiShop | XdUaXduA | 神角直辖店铺,只有这个店铺的登录人员才可以访问 |
XduaApiSubject | i | i,只有创建者自己才可以修改 |
XduaApiRoles | Root | 只要登录就可以创建神角 |
XduaApiResource | role | |
XduaApiKparam | id | |
XduaApiAction | UpdateRolex | |
XduaApiRule | UpdateRolex | |
XduaApiAstates | 0 | 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED) |
XduaApiEnable | true | 接口使能 |
80. 请求参数
名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 说明 |
---|---|---|---|---|---|---|
id | path | string | 是 | rYub4wrT | 要修改的神角ID | |
name | body | string | 否 | 神角的名称,必须唯一,支持汉字、英文字母、数字、英文格式的下划线,必须以英文字母或汉字开头,4~32个字符 | ||
avatar | body | string | 否 | 神角图标,不超过40个字符。 | ||
brief | body | string | 否 | 神角描述,不超过64个字符。 |
81. 返回参数
名称 | 位置 | 类型 | 示例 | 说明 |
---|---|---|---|---|
id | result | string | rYub4wrT | 修改的神角ID |
updates | result | json dict | 修改的内容 |
示例
result字段
{
"id":"rYub4wrT",
"updates":{
"name":"新的神角名",
"brief":"新的神角介绍",
}
}