批量获取身份证号(user/identity_card/batch_get)

使用场景: 批量获取用户身份证号。

是否需额外授权: 应用白名单授权

请求方式: POST (HTTPS

请求地址: https://oapi.epaas.qq.com/user/identity_card/batch_get?access_token=ACCESS_TOKEN

请求包体

{
    "userids": ["90998763"]
}

参数说明:

参数 必须 说明
access_token 调用接口凭证,机构token。用户token只支持查询自己的身份证信息
userids 是(使用用户token时可以为空) 用户orguserid列表,需要确保每个userid都正确

返回结果:

{
    "errmsg": "ok",
    "errcode": 0,
    "userlist": [
      {
          "userid": "90998763",
          "identity_card": "fUHtI8bWQxfYYndyEqQQNGcFCV2LkPfIPpAyKMXqZB4="
      }
    ]
}

参数说明:

参数 说明
errcode 返回码,0为正常
errmsg 对返回码的文本描述内容
userlist 数据列表
userlist.userid 用户id,在机构内唯一
userlist.identity_card 证件类型__证件号码(注意:是连续两个下划线),证件类型参考《证件类型》;返回值为加密数据参考附录参数加解密说明 里开放接口参数加解密章节)

密码加解密demo示例

明文: 112233

EncodeAesKey: vzH3cwuHt4Uo6IIPcWjHl9hqu7NCAUfN6cGxGKbicBh

密文: fUHtI8bWQxfYYndyEqQQNGcFCV2LkPfIPpAyKMXqZB4=

批量根据身份证号查询用户

使用场景: 批量根据身份证号查询用户

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要
用户凭证 未支持
机构凭证 支持 -

请求方式: POST(HTTPS

请求地址: https://oapi.epaas.qq.com/common/user/batch_search_by_identity

Query参数:

参数 类型 必填 说明
access_token string 接口调用凭证

Body参数:

参数 类型 必须 说明
identity_list []string 证件号id列表, 列表长度<=1000
role_id_list []int 角色id列表, 参考角色类型

返回参数:

参数 类型 说明
errcode int32 返回码,0为正常
errmsg string 对返回码的文本描述内容
data_list 用户列表
data_list.userid string 用户id
data_list.name string 姓名
data_list.role_id int 角色id, 参考角色类型
data_list.identity string 证件号

请求示例:

POST https://oapi.epaas.qq.com/common/user/batch_search_by_identity?access_token=ACCESS_TOKEN

请求包体

{
    "identity_list": ["420312199901010202,420312199901010333"],
    "role_id_list":[11,12]
}

返回示例:

{
    "errcode": 0,
    "errmsg": "ok",
    "data_list": [
        {
            "userid": "3722428406",
            "name": "张三",
            "role_id": 11,
            "identity": "420312199901010202"
        },
        {
            "userid": "3722428406",
            "name": "李四",
            "role_id": 2,
            "identity": "420312199901010333"
        }
    ]
}
© 1998 - 2021 Tencent Inc. All Rights Reserved all right reserved,powered by ePaaS.更新时间: 2024-03-04 10:24:47

results matching ""

    No results matching ""

    results matching ""

      No results matching ""