项目查询

  • 接口:common/projects/v2/findByPage
  • Method:GET
  • 接口说明:根据其他查询条件查询(支持按照最后更新时间、项目类型、上级项目编码查询)
  • 多语言环境:实现多语言环境方式是在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种

请求参数

字段名称 字段类型 字段描述 是否必填 长度
bizId String 业务唯一识别码 true 255
timestamp long 时间戳 true
page_num Integer 分页页数 (默认1,最小1) false
page_size Integer 分页条数 (默认100,仅支持20,50,100) false
parent_code String 上级编码 false 64
department_code String 归属部门编码 false 64
owner_user_name String 项目主管用户名 false 64
owner_code String 项目主管员工号 false 64
start_datetime long 最后更新时间-开始时间(13位数字时间戳) false 13
end_datetime long 最后更新时间-结束时间(13位数字时间戳) false 13

入参说明: 1、如果项目主管用户名和项目主管员工号都有值,以项目主管用户名进行查询

请求示例

common/projects/v2/findByPage?timestamp=1658885564000&bizId=f6914265-a4b4-429c-bb58-1533e1ddfa37&parent_code=apipro001

返回参数

默认返参

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.page_num Integer 当前页数
data.total_page Integer 总页数
data.page_size Integer 分页条数
data.total_count Integer 总条数
date.page_info Array 数据结果列表
data.page_info.page_info.code String 项目编码
data.page_info.page_info.project_name String 项目名称
data.page_info.page_info.parent_vo.code String 上级项目编码
data.page_info.page_info.parent_vo.project_name String 上级项目名称
data.page_info.page_info.enabled_flag String 启用/禁用
data.page_info.page_info.last_update_date long 最后更新日期

可配置返参

字段名称 字段类型 字段描述
data.page_info.parent.* JSONObject 关联父项目字段
data.page_info.department.* JSONObject 关联所属部门字段
data.page_info.owner_vo.* JSONObject 关联主管员工字段
data.page_info.project_code String 项目编码
data.page_info.project_name String 项目名称
data.page_info.budget String 预算
data.page_info.status String 状态
data.page_info.enabled_flag String 启用标志
data.page_info.staff_flag String 权限标志
data.page_info.description String 描述
data.page_info.last_update_date long 最后更新日期

返回示例

{
  "resCode": 200000,
  "resMsg": "success",
  "bizId": "f6914265-a4b4-429c-bb58-1533e1ddfa37",
  "data": {
    "page_size": 100,
    "page_num": 1,
    "total_count": 1,
    "total_page": 1,
    "is_first_page": true,
    "is_last_page": true,
    "page_info": [
      {
        "code": "apipro002",
        "parent_vo": {
          "code": "apipro001",
          "project_name": "接口测试项目1"
        },
        "staff_flag": "N",
        "project_name": "接口测试项目2",
        "description": "接口测试创建项目",
        "enabled_flag": "Y",
        "project_status": "complete",
        "owner_vo": {
          "full_name": "接口测试用户2",
          "user_name": "绪文api"
        },
        "department_vo": {
          "code": "APTT",
          "department_name": "接口测试部门2",
          "department_code": "APTT"
        }
      }
    ]
  }
}

results matching ""

    No results matching ""