1. 描述

创建社授。

2. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以以Super社授创建自己的社授。

3. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name AddUsror
Url https://api.xdua.com/usror
Method POST
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod ADD
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 需要登录
XduaApiRoles Super Super可以创建社授
XduaApiResource role
XduaApiKparam name
XduaApiAction CreateUsror
XduaApiRule CreateUsror
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 是 Super 社授的代号,16个字符以内,小写字母,数字和字母，不能有特殊符号，一旦创建，不可修改
granter body string 是 Super 授权社授代号,code标准格式

5. 返回参数

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

6. 错误码

7. 描述

删除社授。

8. 调用场景

根用户在http://consoler.{zond_id}.xdua.com登录. 它会让资源永久消失。。

9. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DelUsror
URL https://api.xdua.com/usror
Method DELETE
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DEL
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有资源创建者自己可以访问这个口
XduaApiRoles Super Super可以删除社授
XduaApiResource role
XduaApiKparam id
XduaApiAction DeleteUsror
XduaApiRule DeleteUsror
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. 调用场景

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

管理员（Super）

  1. 登录http://consoler.{zond_id}.xdua.com后,
  2. 根据条件查询社授，条件是某个社授。
  3. 点击冻结，可以关闭社授。

15. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DisUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DIS
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖社授,只有这个社授的登录人员才可以访问
XduaApiSubject u 必须是创建者才可以自闭社授
XduaApiRoles Super 只有神级管理员才可以关闭普通开发者的社授
XduaApiResource role
XduaApiKparam id
XduaApiAction DisableUsror
XduaApiRule DisableUsror
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. 调用场景

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

21. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DolUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod DOL
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有创建者自己才能删除自己创建的社授
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction DeletoUsror
XduaApiRule DeletoUsror
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. 调用场景

管理员（Super）

  1. 登录http://consoler.xdua.com后,
  2. 根据条件查询社授，条件是某个被冻结的社授。
  3. 点击解冻，可以解冻店铺。

27. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name EnbUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod ENB
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u 神登录后解冻开发者的社授
XduaApiRoles Super 只有神才可以解冻社授
XduaApiResource role
XduaApiKparam id
XduaApiAction EnableUsror
XduaApiRule EnableUsror
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. 调用场景

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

33. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/usror
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod GET
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u !表示除了允许匿名用户之外的所有用户访问
XduaApiRoles Super 只要Super才可以访问其它用户的社授
XduaApiResource role
XduaApiKparam id
XduaApiAction GetUsror
XduaApiRule GetUsror
XduaApiUsrorAstate 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. 调用场景

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

39. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/usror
Method GET
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod GIT
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有自己才可以访问自己创建的社授
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction GetUsror
XduaApiRule GetUsror
XduaApiUsrorAstate 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. 调用场景

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

45. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name OffUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod OFF
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只能社授的创建者才能下线自己的社授
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction OfflineUsror
XduaApiRule OfflineUsror
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. 调用场景

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

51. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name PubUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod PUB
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i 只有社授的创建者自己才能上下线自己的社授
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction OnlineUsror
XduaApiRule OnlineUsror
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. 调用场景

用户在社区应用上查询和自己有关的授权。

57. URL

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

58. 请求参数

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

59. 返回参数

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

result.list部分

59.1. schema == "GroupByShop1"

名称 位置 类型 示例 说明
shop_id result.list[] string rYub4wrT 店铺的ID
shop_name result.list[] string 店铺的名字
role_names result.list[] string 在店铺的角色列表，以逗号隔开

59.2. schema == "GroupByCorp1"

名称 位置 类型 示例 说明
corp_id result.list[] string rYub4wrT 企业的ID
corp_name result.list[] string 企业的名字
role_names result.list[] string 在企业的角色列表，以逗号隔开

60. 错误码

61. 示例

61.1. 在慢护通管理后台 admin.manhu.cn 请求某人所在的店铺


let api_name  = "授权查询";
query = {
    schema:"GroupByShop1",
}
let res = await xduaClient.qriUsror(query)
console.log(res);
console.log(JSON.stringify(res));
if(res.error == 0){
    console.log(api_name+"成功 ");
}else{
    console.log(api_name+"失败 "+res.reason);
}

// 返回的数据格式

{
    "status": 200,
    "apid": "7A2E48C4-471A-42E4-B10B-7C7BFC5FF118",
    "apis": "QriUsror",
    "error": 0,
    "result": {
        "limit": 20,
        "total": 7,
        "sort": {
            "inc": "DESC"
        },
        "count": 7,
        "page": 1,
        "pages": 1,
        "list": [{
            "shop_id": "Facility",
            "role_names": "店长,管家",
            "shop_name": "商务中心老年公寓"
        }, {
            "shop_id": "LiKVu9ie",
            "role_names": "店长,管家",
            "shop_name": "济南市兴隆老年公寓"
        }, {
            "shop_id": "S8pDO17B",
            "role_names": "店长",
            "shop_name": "济南市历城区南部山区德慧家园养老院"
        }, {
            "shop_id": "SGKNy3gy",
            "role_names": "店长",
            "shop_name": "济南市历城区云天使养老院"
        }, {
            "shop_id": "mh5Jmrxw",
            "role_names": "店长",
            "shop_name": "济南舜康老年公寓"
        }, {
            "shop_id": "pLTNw08Z",
            "role_names": "店长",
            "shop_name": "济南诚通老年公寓"
        }, {
            "shop_id": "q0B76Hsc",
            "role_names": "店长",
            "shop_name": "济南市槐荫区和颐家养老院"
        }],
        "format": "raw",
        "where": [],
        "offset": 0
    },
    "debug": [],
    "message": "message",
    "reason": "success"
}

61.2. 在慢护通管理后台 admin.manhu.cn 请求某人所在的企业列表


query = {
    schema:"GroupByCorp1",
}
let res2 = await xduaClient.qriUsror(query)
console.log(res2);
console.log(JSON.stringify(res2));
if(res.error == 0){
    console.log(api_name+"成功 ");
}else{
    console.log(api_name+"失败 "+res.reason);
}


// 返回的数据格式

{
    "status": 200,
    "apid": "CDEEC90C-5ACC-4BFF-B335-6625666885F2",
    "apis": "QriUsror",
    "error": 0,
    "result": {
        "limit": 20,
        "total": 5,
        "sort": {
            "inc": "DESC"
        },
        "count": 5,
        "page": 1,
        "pages": 1,
        "list": [{
            "corp_id": "1pMYmQMk",
            "role_names": "创始人,总裁",
            "corp_name": "中国科学院计算技术研究所临沂分所"
        }, {
            "corp_id": "35k7iLfk",
            "role_names": "创始人,总裁",
            "corp_name": "中国科学院计算技术研究所济宁分所"
        }, {
            "corp_id": "3KTUEpcT",
            "role_names": "创始人,总裁",
            "corp_name": "中国科学院计算技术研究所宁波分所"
        }, {
            "corp_id": "IctJinan",
            "role_names": "创始人,总裁",
            "corp_name": "中国科学院计算技术研究所济南分所"
        }, {
            "corp_id": "Srb3CRFw",
            "role_names": "创始人,总裁",
            "corp_name": "中国科学院计算技术研究所苏州分所"
        }],
        "format": "raw",
        "where": [],
        "offset": 0
    },
    "debug": [],
    "message": "message",
    "reason": "success"
}

62. 描述

查询社授。

63. 调用场景

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

64. 配置参数

参数意义参考接口参数

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

65. URL

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

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 RccUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod RCC
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject u u表示除了允许匿名用户之外的所有用户访问
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction RecycleUsror
XduaApiRule RecycleUsror
XduaApiAstates 0 按序app,zone,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 SetUsror
URL https://api.xdua.com/usror
Method PUT
XduaApiHttpSchema HTTPS 只走HTTPS
XduaApiMethod SET
XduaApiColor X 只有持有神令牌，才可以创建社授
XduaApiAudience {zone_console_app_id} 只有app_id为{zone_console_app_id}的应用，也就是consoler.xdua.com才可以发起本请求
XduaApiShop {zone_id} 社授直辖店铺,只有这个店铺的登录人员才可以访问
XduaApiSubject i i,只有创建者自己才可以修改
XduaApiRoles Super 只要登录就可以创建社授
XduaApiResource role
XduaApiKparam id
XduaApiAction UpdateUsror
XduaApiRule UpdateUsror
XduaApiAstates 0 按序app,zone,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 ""