外部人员证件查询

  • 接口：/common/externalPersonCard/findByPage
  • Method：GET
  • 接口说明：根据指定查询条件查询外部人员证件信息

请求参数

字段名称 字段类型 字段描述 是否必填 长度
bizId String 业务唯一识别码 true 255
timestamp long 时间戳 true 13
page_num Integer 分页页数 (默认1，最小1) false
page_size Integer 分页条数 (默认100，仅支持20，50，100) false
codes List 证件号码列表(最多100个) false
person_codes List 外部人员编码列表(最多100个) false
card_types List 证件类型列表(最多10个) false
start_datetime long 最后更新时间-开始时间(13位数字时间戳) false 13
end_datetime long 最后更新时间-结束时间(13位数字时间戳) false 13

请求示例

/common/externalPersonCard/findByPage?codes=224696202560952574&person_codes=userCode666&page_size=20&page_num=1&card_types=2

返回参数

字段名称 字段类型 字段描述
resCode Integer 状态码
resMsg String 描述
data.page_num Integer 分页数
data.total_page Integer 总页数
data.page_size Integer 分页大小
data.total_count Integer 总条数
data.is_first_page boolean 是否第一页
data.is_last_page boolean 是否最后一页
data.page_info Array 数据结果列表
data.page_info[0].person_code String 外部人员编码
data.page_info[0].card_type String 证件类型
data.page_info[0].card_no String 证件号码
data.page_info[0].time_limit String 有效期
data.page_info[0].enabled_flag String 启用标识：Y/N
data.page_info[0].nationality String 国籍
data.page_info[0].primary_flag String 是否是默认证件：Y/N
data.page_info[0].creation_date long 创建时间
data.page_info[0].last_update_date long 最后更新时间

证件类型枚举值

值 描述
1 身份证
2 护照
3 学生证
4 军人证
7 回乡证
8 台胞证
10 港澳通行证
20 外国人永久居留证
21 旅行证
22 台湾通行证
99 其他

返回示例

{
    "resCode": 200000,
    "resMsg": "success",
    "bizId": "xxx",
    "data": {
        "page_size": 20,
        "page_num": 1,
        "total_count": 1,
        "total_page": 1,
        "is_first_page": true,
        "is_last_page": true,
        "page_info": [
            {
                "last_update_date": 1754016877000,
                "creation_date": 1754016877000,
                "person_code": "userCode666",
                "card_type": "2",
                "card_no": "224696202560952574",
                "time_limit": "2037-07-10",
                "enabled_flag": "Y",
                "nationality": "CHN",
                "primary_flag": "Y"
            }
        ]
    }
}

results matching ""

    No results matching ""