批量获取身份证号(user/identity_card/batch_get)
使用场景: 批量获取用户身份证号。
是否需额外授权: 应用白名单授权
请求方式: POST (HTTPS)
请求地址: https://test-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://test-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://test-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"
}
]
}