1. 描述

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

2. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以以Zoon角色创建自己的企业。

3. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name AddCorp
Url https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam name
XduaApiAction CreateCorp
XduaApiRule CreateCorp
XduaApiAstates 0 按序app,zone,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] 企业创建时遵从简单第一步原则，创建只需要企业名和企业执照号两个属性就可以创建企业。剩下通过setcorp来完善。

5. 返回参数

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

6. 错误码

7. 描述

删除企业。

8. 调用场景

根用户在http://consoler.{zond_id}.xdua.com登录，可以永久删除任何处于软删除状态的企业。这个权限不给Admin，是因为这个是权限非常高的操作，它会让所有资源消失。。

9. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DelCorp
URL https://api.xdua.com/zone
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 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction DeleteCorp
XduaApiRule DeleteCorp
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状态，也只有Admin角色重新打开这个企业。

15. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DisCorp
URL https://api.xdua.com/zone
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 Admin 只有神级管理员才可以关闭普通开发者的企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction DisableCorp
XduaApiRule DisableCorp
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后,可以点击自己的企业，然后删除掉。如果哪天后悔了，可以联系Admin来恢复。

21. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name DolCorp
URL https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction DeletoCorp
XduaApiRule DeletoCorp
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. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name EnbCorp
URL https://api.xdua.com/zone
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 Admin 只有神才可以解冻企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction EnableCorp
XduaApiRule EnableCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

27. 请求参数

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

28. 返回参数

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

29. 错误码

30. 描述

详情企业。

31. 调用场景

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

32. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/zone
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 Admin 只要Admin才可以访问其它用户的企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction GetCorp
XduaApiRule GetCorp
XduaApiCorpAstate 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 接口使能

33. 请求参数

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

34. 返回参数

名称 位置 类型 示例 说明
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": {


    },
}

35. 错误码

36. 描述

私详企业。

37. 调用场景

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

38. 配置参数

参数名 参数值 说明
URL https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction GetCorp
XduaApiRule GetCorp
XduaApiCorpAstate 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 接口使能

39. 请求参数

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

40. 返回参数

名称 位置 类型 示例 说明
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": {


    },
}

41. 错误码

42. 描述

下线企业。

43. 调用场景

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

44. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name OffCorp
URL https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction OfflineCorp
XduaApiRule OfflineCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

45. 请求参数

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

46. 返回参数

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

47. 错误码

48. 描述

发布企业。

49. 调用场景

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

50. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name PubCorp
URL https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction OnlineCorp
XduaApiRule OnlineCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

51. 请求参数

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

52. 返回参数

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

53. 错误码

54. 描述

私查企业。

55. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以以None角色查询所有社区。

56. 配置参数

参数意义参考接口参数

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

57. URL

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

58. 请求参数

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

59. 返回参数

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

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 企业最近更新时间

60. 错误码

61. 描述

查询企业。

62. 调用场景

开发者登录http://consoler.{zond_id}.xdua.com后,可以以God角色查询所有社区。

63. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name QryCorp
URL https://api.xdua.com/zone
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 Admin 必须是Admin才可以查询角色
XduaApiResource zone
XduaApiKparam where 常量where
XduaApiAction QueryCorp
XduaApiRule QueryCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

64. URL

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

65. 请求参数

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

66. 返回参数

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

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 企业最近更新时间

67. 错误码

68. 描述

回收企业。

69. 调用场景

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

70. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name RccCorp
URL https://api.xdua.com/zone
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 Admin 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction RecycleCorp
XduaApiRule RecycleCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

71. 请求参数

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

72. 返回参数

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

73. 错误码

74. 描述

修改企业。 修改企业。默认企业是不可以修改的。企业的属性只能由企业的创建者和相应的被授权角色可以修改。但是企业的enabled还有控制属性是可以本户群的红神或者拥有相应权限才可以。

75. 调用场景

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

76. 配置参数

参数意义参考接口参数

参数名 参数值 说明
Name SetCorp
URL https://api.xdua.com/zone
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 Zoon 只要登录就可以创建企业
XduaApiResource zone
XduaApiKparam id
XduaApiAction UpdateCorp
XduaApiRule UpdateCorp
XduaApiAstates 0 按序app,zone,corp,shop,user,token,login的状态都必须是0(STATE_ENABLED)
XduaApiEnable true 接口使能

77. 请求参数

名称 位置 类型 必填 默认值 示例 说明
id path string 是 rYub4wrT 要修改的企业ID
code body string 否 企业代号 企业营业执照号
type body string 否 事业单位 企业种类
name body string 否 企业名称 企业名称，不小于32个字符
brief body String 否 华天逸键是一家专注老人健康的企业。 企业的简介。
avatar body string 否 e10adc3949ba59abbe56e057f20f883e.jpg 企业头像，不小于40个字符

78. 返回参数

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

示例

result字段

{
    "id":"rYub4wrT",
    "updates":{
        "name":"新的企业名",
        "brief":"新的企业介绍",    
    }    
}

79. 错误码

results matching ""

    No results matching ""