# 创建用户
# 接口说明:
新增用户,若用户已存在,则进行更新
# 请求方法:
POST(application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/user/manage/create?access_token="access_token"
# 接口权限申请:
发送需要申请的接口到 seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com , lindayyang@tencent.com , ronniewan@tencent.com),申请时需要注明应用名称、应用APPKEY、及应用使用场景。
# 参数说明(分行业用户字段说明):
{
"card_number": "123456789",
"name": "张三",
"gender": "男",
"head_image": "http://xxx/xx.png",
"identity_type": "员工/访客/学生...",
"identity_title": "经理/总监/部长/本科生...",
"card_type": "1",
"id_card": "4XXX***7",
"country": "CHN",
"staff_status": "正常",
"telephone": "137***8",
"organization": "AA/BB/CC",
"employer": "XX研究所",
"dorm_number": "A栋206",
"remark": "00000000",
"physical_chip_number": "EAEB1234",
"physical_card_number": "00001234",
"physical_card_status": "正常",
"email": "weixiao@tencent.com",
"expire_at": "2019-01-01 00:00:00",
"qq": "12345678",
"nation": "汉族",
"origin_place": "陕西省",
"graduated_school": "XX中学",
"address": "仙桃市郑场镇潘阳村八组",
"grade": "2016",
"college": "信息科学与技术学院",
"profession": "计算机系",
"class": "软件1班",
"campus": "南校区",
"school_period": "幼儿园",
"register_year": "2022"
}
参数 | 是否必填 | 类型 | 实例 | 说明 |
---|---|---|---|---|
access_token | 是 | String | 应用有效凭证 | |
card_number | 是 | string | weixiao2164257621 | 电子卡号/学工号 |
name | 是 | string | 张三 | 姓名 |
gender | 否 | string | 男 | 性别 |
head_image | 否 | string | http://xxx/xx.png | 头像url |
identity_type | 是 | string | 员工/访客/学生... | 身份类型 |
identity_title | 否 | string | 经理/总监/部长/本科生... | 职称 |
card_type | 否 | Integer | 1:身份证 | 证件类型 |
id_card | 否 | string | 4XXX***7 | 证件号 |
country | 否 | string | CHN | 国家 |
telephone | 否 | string | 137***8 | 手机号 |
organization | 是 | string | AA/BB/CC | 组织架构, 可以传多个用;隔开,其中第一个组织架构会保存为用户主部门 |
employer | 否 | string | XX研究所 | 工作单位 |
dorm_number | 否 | string | A栋206 | 宿舍号 |
remark | 否 | string | 00000000 | 备注 |
否 | string | weixiao@tencent.com | 邮箱 | |
expire_at | 否 | datetime | 2019-01-01 00:00:00 | 有效时间 |
否 | string | 12345678 | qq号 | |
nation | 否 | string | 汉族 | 名族 |
origin_place | 否 | string | 陕西省 | 户籍 |
graduated_school | 否 | string | XX中学 | 毕业院校 |
address | 否 | string | 仙桃市郑场镇潘阳村八组 | 住址 |
grade | 否 | string | 2016 | 年级 |
college | 否 | string | 信息科学与技术学院 | 学院名称 |
profession | 否 | string | 计算机系 | 系的名称 |
class | 否 | string | 软件1班 | 班级 |
campus | 否 | string | 南校区 | 校区 |
school_period | 否 | String | 幼儿园 | 学段 |
register_year | 否 | int | 2022 | 入学年份 |
# 响应说明:
{
"errcode": 0,
"errmsg": "OK"
}
参数 | 必填 | 类型 | 实例 | 说明 | |
---|---|---|---|---|---|
errcode | 是 | Integer | 0 | 响应状态码,0为成功 | |
errmsg | 是 | String | success | 响应状态信息 |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
- access_token 的获取参考获取应用有效凭证。
← 获取主体基本信息 获取单个组织架构成员 →