有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

根据相关关键词搜索成员。
注意
只有主体对应用处于开启状态时,应用方才能调通本文档中接口拿到该主体相关数据。
说明
发送需要申请的字段到 zhimuli@tencent.com 进行申请(邮件同时也抄送至 hongfuhuang@tencent.com,ronniewan@tencent.com),申请时需要注明应用名称、应用 APPKEY、及应用使用场景。

请求方法

POST(application/json)

请求地址

https://open.wecard.qq.com/cgi-bin/user/search?access_token=access_token

输入参数

参数名称
参数描述
参数类型
是否必填
备注
access_token
应用有效凭证
String
通过获取应用有效凭证接口获取
keywords
关键词,仅支持电子卡号或姓名的精确搜索
String
-

输出参数

参数名称
参数描述
参数类型
是否必填
备注
errcode
错误码
Integer
-
errmsg
错误信息
String
-
userlist
成员列表
List
以下字段均为 userlist 中一个成员的字段
card_number
电子卡号
String
-
name
姓名
String
-
identity_type
身份类型
String
1:其他,2:学生,3:教职工,4:校友
grade
年级(需申请)
String
-
college
学院(需申请)
String
-
profession
专业(需申请)
String
-
class
班级(需申请)
String
-
identity_title
身份职称(需申请)
String
-
gender
性别(需申请)
Integer
-
organization
组织架构(需申请)
List
-
role
角色(需申请)
List
-
campus
校区(需申请)
String
-
dorm_number
宿舍号(需申请)
String
-
physical_chip_number
物理芯片号(需申请)
String
-
physical_card_number
物理卡号(需申请)
String
-
nation
民族(需申请)
String
-
birthday
生日(需申请)
String
-
origin_place
生源地(需申请)
String
-
graduated_school
毕业学校(需申请)
String
-
address
家庭住址(需申请)
String
-
contact_person
联系人(需申请)
String
-
contact_phone
联系人手机号(需申请)
String
-
email
邮箱(需申请)
String
-
id_card
身份证(需申请)
String
-
telephone
手机号(需申请)
String
-
bind_status
绑定状态(需申请)
Integer
-
frozen_status
冻结状态(需申请)
Integer
-
active_status
激活状态(需申请)
Integer
-
entrust_status
签约状态(需申请)
Integer
0:未签约,1:已签约
expire_at
有效期结束时间
String
-
start_at
有效期开始时间
String
-
head_image
头像
String
-
serial_number
编号
String
-
job_title
职务
String
-

示例

输入示例

{
"keywords": "keywords"
}

输出示例

{
"errcode":0,
"errmsg":"success",
"userlist":[
{
"card_number":"1604030126",
"name":"evan1",
"identity_type":"1",
"grade":"2016",
"college":"人居环境工程学院",
"profession":" 工程造价",
"class":"1班",
"identity_title":"本科生",
"gender":1,
"organization":[
2,
222,
496
],
"role":[
1,
2
],
"campus":"东校区",
"dorm_number":"至善园",
"physical_chip_number":"",
"physical_card_number":"",
"nation":"汉族",
"birthday":"20020319",
"origin_place":"深圳市",
"graduated_school":"小碧中学",
"address":"广东省深圳市XXX",
"contact_person":"",
"contact_phone":"",
"email":"xxxxx@qq.com",
"id_card":"440XXXXXXXXXXXXXXX",
"telephone":"137XXXXXXXX",
"bind_status":0,
"frozen_status":0,
"active_status":0,
"entrust_status":0,
"expire_at":"2019-12-31 12:00:00",
"start_at":"2019-12-31 12:00:00",
"head_image":"https://xxxxxxxxxxxxxx/a.png",
"serial_number":"19527123",
"job_title":"经理"
}
]
}