上下游企业分组管理

企业可通过本组接口查询、创建、修改、删除上下游企业分组，并对下游企业进行加入分组、移出分组、调整分组归属和查询所有分组归属等操作。

使用说明

1. 本组接口只操作当前 access_token 对应的上游企业数据，请求体中不需要传入上游企业 tenant_id。
2. 分组查询返回分组主数据，包含分组层级、路径和是否有子分组等字段。
3. 企业查询和企业归属查询返回企业分组归属数据，包含主分组、多分组和分组路径等字段。
4. 特殊分组 ID 说明：
   • 0：默认分组。企业查询、企业调整的来源分组和目标分组允许使用。
   • 1：根节点。创建一级分组时 parent_id 可使用；企业归组操作不允许使用。
   • 大于 1：业务分组。

查询企业分组列表

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/group/list?access_token=x

Query参数：

Body参数：

{
  "search_name": "华东",
  "parent_id": 1
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": [
    {
      "id": 2089299227464173890,
      "tenant_id": "wpDkH9EAAAiUqMy8eay_nTYyUJn420pQ",
      "ws_tenant_id": 10001,
      "parent_id": 1,
      "group_name": "华东区",
      "group_order": 1,
      "level": 1,
      "path_group_ids": [2089299227464173890],
      "path_group_names": ["华东区"],
      "has_children": true,
      "child_count": 2,
      "corp_count": 10,
      "version": 1,
      "gmt_create": 1787043600,
      "gmt_modified": 1787043600
    }
  ]
}

返回说明：

创建企业分组

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/group/create?access_token=x

Query参数：

Body参数：

{
  "group_name": "华东一区",
  "parent_id": 1
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": 2089299227464173890
}

返回说明：

修改企业分组名称

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/group/update?access_token=x

Query参数：

Body参数：

{
  "group_id": 2089299227464173890,
  "group_name": "华东一区"
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": true
}

返回说明：

删除企业分组

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/group/delete?access_token=x

Query参数：

Body参数：

{
  "group_id": 2089299227464173890
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": true
}

返回说明：

查询分组下的下游企业列表

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/relation/cursor?access_token=x

Query参数：

Body参数：

{
  "search_key": "示例企业",
  "group_id": 2089299227464173890,
  "group_ids": [2089299227464173890],
  "cursor": "0",
  "page_size": 20,
  "soft": 1
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "next_cursor": "99",
    "page_size": 20,
    "records": [
      {
        "relation_tenant_id": "wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW",
        "relation_corp_name": "示例下游企业",
        "gmt_create": "2026-08-18 10:00:00",
        "gmt_modified": "2026-08-18 11:00:00",
        "group_id": 2089299227464173890,
        "primary_group_id": 2089299227464173890,
        "group_ids": [2089299227464173890],
        "group_names": ["华东一区"],
        "group_paths": [
          {
            "group_id": 2089299227464173890,
            "group_name": "华东一区",
            "path_group_ids": [2089299227464173890],
            "path_group_names": ["华东一区"]
          }
        ]
      }
    ]
  }
}

返回说明：

企业加入指定分组

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/relation/groups/add?access_token=x

Query参数：

Body参数：

{
  "relation_tenant_ids": ["wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW"],
  "group_ids": [2089299227464173890],
  "primary_group_id": 2089299227464173890
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": true
}

返回说明：

企业从指定分组移出

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/relation/groups/unrelate?access_token=x

Query参数：

Body参数：

{
  "relation_tenant_ids": ["wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW"],
  "group_id": 2089299227464173890
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "success_relation_tenant_ids": ["wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW"],
    "noop_relation_tenant_ids": []
  }
}

返回说明：

调整企业分组归属

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/relation/groups/move?access_token=x

Query参数：

Body参数：

{
  "relation_tenant_ids": ["wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW"],
  "source_group_id": 0,
  "target_group_id": 2089299227464173890
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "success_relation_tenant_ids": ["wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW"],
    "noop_relation_tenant_ids": []
  }
}

返回说明：

查询企业所有分组归属

请求方式： POST（HTTPS）

请求地址： https://open.wshoto.com/openapi/tenant/appshare/relation/groups/query?access_token=x

Query参数：

Body参数：

{
  "relation_tenant_ids": [
    "wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW",
    "wpDkH9EAAARjY-2kJluRJl7tLDZ_DRMW"
  ]
}

返回值：

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW": {
      "relation_tenant_id": "wpDkH9EAAARjY-1kJluRJl7tLDZ_DRMW",
      "relation_corp_name": "示例下游企业",
      "gmt_create": "2026-08-18 10:00:00",
      "gmt_modified": null,
      "group_id": 2089299227464173890,
      "primary_group_id": 2089299227464173890,
      "group_ids": [2089299227464173890],
      "group_names": ["华东一区"],
      "group_paths": [
        {
          "group_id": 2089299227464173890,
          "group_name": "华东一区",
          "path_group_ids": [2089299227464173890],
          "path_group_names": ["华东一区"]
        }
      ]
    }
  }
}

返回说明：