应用列表相关接口

用户拉取可用应用列表

使用场景： 用户登录机构后，通过该接口拉取可以使用的应用列表 注意: 可配合/app/sort_user_apps接口自定义应用列表排序

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_install_apps

Query参数:

返回参数：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_install_apps?access_token=ACCESS_TOKEN&terminal_type=1&platform_id=20000

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "app_list": [
    {
      "installed_id": 1000010,
      "appid": 700259,
      "version_id": 1133211,
      "name": "测试回调",
      "icon": "https://xxx.com/cos1.png",
      "index_url": "https://xxx.com/index.html",
      "category_id": 32,
      "second_cate_id": 33,
      "installed_time": "2022-06-15 10:40:31",
      "mini_app_id": "",
      "mini_app_original_id": "",
      "mini_app_home_page": "",
      "app_tags": [],
      "mobile_type": "MERGE",
      "is_marked" : 0,
      "marked_sort" : 0
    }
  ]
}

拉取批量用户可用应用列表

使用场景： 管理员用户查询本机构或下级机构的多个用户的可用应用列表

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/batch_get_install_apps

请求示例

POST https://oapi.epaas.qq.com/app/batch_get_install_apps?access_token=ACCESS_TOKEN

请求参数

{"platform_type":0, "sub_corpid":0, "userids":["3730477619"]}

请求参数:

返回参数：

示例：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "userid": "3730477619",
      "pc_appids": [
        700116
      ],
      "mp_appids": [
        700116
      ]
    }
  ],
  "app_list": [
    {
      "installed_id": 42272,
      "appid": 700116,
      "version_id": 40217,
      "name": "选课报名",
      "icon": "xxx.jpg",
      "index_url": "https://test-v.campus.qq.com/courseregistration/",
      "category_id": 34,
      "category_name": "教务管理",
      "is_frozen": 0,
      "desc": "选课报名"
    }
  ]
}

管理员拉取可管理应用列表（区分已安装和未安装）

使用场景： 拉取市场对机构可见的所有应用列表，包括已安装、未安装的

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_all_apps

Query参数:

返回参数：

visibility_data示例：

{
  "visibility_type": 1,
  "visibility_data": "[12,11,13]" 
}

{
  "visibility_type": 2,
  "visibility_data": "[{\"IsParent\":true,\"Name\":\"局内职工\",\"NodeId\":16023484}]"
  //  IsParent:是否为部门节点，false表示单个成员
  //  Name:部门名称 or 成员名称 
  //  NodeId:部门id or 成员用户id
}

{
  "visibility_type": 3,
  "visibility_data": ""
}

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_all_apps?access_token=ACCESS_TOKEN&platform_id=20000

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "app_list": [
    {
      "appid": 1000010,
      "name": "作业",
      "desc": "查看提交作业",
      "version_id": 34524,
      "logo": "https://xxx.com/cos1.png",
      "is_installed": true,
      "category_id": 32,
      "qywx_suiteid": "ww076bee13853ff46a",
      "pc_role_ids": [
        2,
        11,
        12,
        13,
        14,
        15,
        16,
        19
      ],
      "mp_role_ids": [
        2,
        11,
        12,
        13,
        14,
        15,
        16,
        19
      ],
      "installed_time": "2022-06-15 10:40:31",
      "mini_app_id": "",
      "mini_app_original_id": "",
      "mini_app_home_page": "",
      "app_tags": [],
      "mobile_type": "MERGE"
    }
  ]
}

获得机构应用安装列表（机构token）

使用场景： 机构token拉取应用已安装列表

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/suite/get_suite_installed_list

Query参数:

返回参数：

示例：

请求示例

GET https://oapi.epaas.qq.com/suite/get_suite_installed_list?access_token=ACCESS_TOKEN&platform_id=20000

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "data_list": [
    {
      "suite_installed_id": 1000010,
      "suiteid": 10121,
      "suite_version_id": 12115,
      "suite_icon": "https://xxx.com/cos1.png",
      "suite_type": 1,
      "is_frozen": 0,
      "index_url": "https://www.qq.com",
      "role_id": 12,
      "type": 1,
      "teacher_space_url": "https://www.qq.com",
      "suite_type_name": "教育数据",
      "suite_initial_name": "作业",
      "instruction_notify_url": "https://www.qq.com/notify",
      "notify_change_url": "https://www.qq.com/notify",
      "terminal_id": 1,
      "is_contact": 0,
      "suite_desc": "应用的描述"
    }
  ]
}

查询应用已安装机构简易信息

使用场景： 查询多个应用的已安装机构的数量(查询范围:本机构和下级机构，支持中心校)

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/batch_get_install_orgs_simple

请求示例

POST https://oapi.epaas.qq.com/app/batch_get_install_orgs_simple?access_token=ACCESS_TOKEN

请求参数

{"app_ids":[1234,1235]}

请求参数:

返回参数：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "app_id": 1234,
      "orgs_num": 14
    },
    {
      "app_id": 1235,
      "orgs_num": 64
    }
  ]
}

查询应用已安装机构详情

使用场景： 管理员用户，查询一个应用的已安装机构的详情(查询范围:本机构和下级机构，支持中心校)

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_install_orgs_detail

Query参数:

返回参数：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_install_orgs_detail?access_token=ACCESS_TOKEN&app_id=APPID

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "corpid": 1234,
      "name": "测试小学1"
    },
    {
      "corpid": 1235,
      "name": "测试小学2"
    }
  ]
}

拉取教育局市场应用列表

使用场景： 教育局查询自身教育局市场内的所有应用

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_market_apps

Query参数:

返回参数：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_market_apps?access_token=ACCESS_TOKEN

返回结果：

{
  "RequestId": "0b8e0edf725c1cbe",
  "ErrorCode": "OK",
  "Data": {
    "data_list": [
      {
        "app_id": 1004,
        "name": "通知公告",
        "logo": "https://main.qcloudimg.com/raw/65fd487218d167e85cdd3cb5ca4da2d7.svg",
        "category_id": 32,
        "second_cate_id": 33,
        "mobile_type": "MERGE",
        "desc": "这是慕课的应用介绍",
        "pc_role_ids": [
          2,
          11,
          12,
          13,
          14,
          15,
          16,
          19
        ],
        "mp_role_ids": [
          2,
          11,
          12,
          13,
          14,
          15,
          16,
          19
        ],
        "interface_imgs": [],
        "on_market_time": "2022-06-15 10:40:31",
        "web_url": "",
        "mp_url": "",
        "mini_app_id": "",
        "mini_app_original_id": "",
        "mini_app_home_page": "",
        "app_tags": []
      }
    ]
  }
}

拉取应用分类信息

使用场景： 拉取应用分类信息

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_category_list

Query参数:

返回参数：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_category_list?access_token=ACCESS_TOKEN

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "category_list": [
    {
      "second_cate_list": [
        {
          "category_id": 2925,
          "category_name": "二级分类222222"
        },
        {
          "category_id": 2927,
          "category_name": "二级分类1111"
        },
        {
          "category_id": 2930,
          "category_name": "二级分类44444"
        }
      ],
      "category_id": 2924,
      "category_name": "一级分类"
    }
  ]
}

获取应用详情

使用场景： 获取应用详情

权限说明

请求方式： GET,POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_app_details

Query参数:

返回参数：

价格模式结构体：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_app_details?access_token=ACCESS_TOKEN&app_id=50000

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "app_id": 50000,
  "name": "腾讯智慧校园3.0",
  "logo": "https://v.campus.qq.com/static/img/sc-titleLogo.png",
  "desc": "智慧校园",
  "details": "",
  "pricing_mode": {
    "app_attribute": 0,
    "app_source": 0,
    "payment_method": 0,
    "pricing_type": 0,
    "usage_restriction_days": 0,
    "usage_feature_desc": "",
    "payment_plan_config": ""
  }
}

获取应用市场应用分类统计数据

使用场景： 获取应用市场应用分类统计数据

权限说明

请求方式： GET,POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/get_market_app_statistics

Query参数:

返回参数：

应用一级分类数据结构体：

应用二级分类数据结构体：

示例：

请求示例

GET https://oapi.epaas.qq.com/app/get_market_app_statistics?access_token=ACCESS_TOKEN&market_id=22463

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "market_id": 22463,
  "market_name": "德育测试",
  "app_num": 7,
  "category_app_data": [
    {
      "category_id": 5,
      "category_name": "办公",
      "app_num": 7,
      "second_category_app_data": [
        {
          "CategoryId": 0,
          "CategoryName": "默认",
          "AppNum": 7
        }
      ]
    }
  ]
}

添加收藏应用

使用场景： 用户添加收藏应用

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/mark_apps

请求示例

POST https://oapi.epaas.qq.com/app/mark_apps?access_token=ACCESS_TOKEN

请求参数

{"app_ids":[800791,800794,800833]}

请求参数:

返回参数：

示例：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "app_id": 800791,
      "sort": 1
    },
     {
      "app_id": 800794,
      "sort": 2
    }
  ]
}

删除收藏应用

使用场景： 用户删除收藏应用

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/delete_marked_apps

请求示例

POST https://oapi.epaas.qq.com/app/delete_marked_apps?access_token=ACCESS_TOKEN

请求参数

{"app_ids":[800791,800794,800833]}

请求参数:

返回参数：

示例：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0
}

排序收藏应用

使用场景： 用户添加收藏应用

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/sort_marked_apps

请求示例

POST https://oapi.epaas.qq.com/app/sort_marked_apps?access_token=ACCESS_TOKEN

请求参数

{"app_ids":[800791,800794,800833]}

请求参数:

返回参数：

示例：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0,
  "data_list": [
    {
      "app_id": 800791,
      "sort": 1
    },
     {
      "app_id": 800794,
      "sort": 2
    }
  ]
}

用户自定义应用列表排序

使用场景： 用户自定义应用列表排序, 在/app/get_install_apps会按此排序

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/app/sort_user_apps

请求示例

POST https://oapi.epaas.qq.com/app/sort_user_apps?access_token=ACCESS_TOKEN

请求参数

{"app_ids":[800791,800794,800833]}

请求参数:

返回参数：

示例：

返回结果：

{
  "errmsg": "ok",
  "errcode": 0
}