# 创建用户
# 接口说明:
新增用户,若用户已存在,则进行更新
# 请求方法:
POST(application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/user/manage/create?access_token="access_token"
# 参数说明:
{
"card_number":"123456789",
"name":"张三",
"gender": "男",
"head_image": "http://xxx/xx.png",
"grade":"2016",
"college":"信息科学与技术学院",
"profession":"计算机系",
"class":"软件1班",
"identity_type":"学生",
"identity_title": "经理/总监/部长/本科生...",
"card_type": "1",
"id_card":"4XXX***7",
"country":"CHN",
"staff_status": "正常",
"telephone":"137***8",
"organization":"AA/BB/CC",
"campus":"南校区",
"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":"仙桃市郑场镇潘阳村八组"
}
参数 | 是否必填 | 类型 | 实例 | 说明 |
---|---|---|---|---|
access_token | 是 | String | 应用有效凭证 | |
card_number | 是 | string | weixiao2164257621 | 电子卡号/学工号 |
name | 是 | string | 张三 | 姓名 |
gender | 否 | string | 男 | 性别 |
head_image | 否 | string | http://xxx/xx.png | 头像url |
grade | 否 | string | 2016 | 年级 |
college | 否 | string | 信息科学与技术学院 | 学院名称 |
profession | 否 | string | 计算机系 | 系的名称 |
class | 否 | string | 软件1班 | 班级 |
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 | 组织架构 |
campus | 否 | string | 南校区 | 校区 |
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 | 仙桃市郑场镇潘阳村八组 | 住址 |
# 响应说明:
{
"errcode": 0,
"errmsg": "OK"
}
参数 | 必填 | 类型 | 实例 | 说明 | |
---|---|---|---|---|---|
errcode | 是 | Integer | 0 | 响应状态码,0为成功 | |
errmsg | 是 | String | success | 响应状态信息 |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
- access_token的获取参考获取应用有效凭证。