# 创建用户

# 接口说明:

新增用户,若用户已存在,则进行更新

# 请求方法:

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 备注
email string weixiao@tencent.com 邮箱
expire_at datetime 2019-01-01 00:00:00 有效时间
qq 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 响应状态信息

# 注意事项

  1. 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
  2. access_token 的获取参考获取应用有效凭证