# 创建用户

# 接口说明:

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

# 请求方法:

POST(application/json)

# 请求地址:

https://open.wecard.qq.com/cgi-bin/user/manage/create?access_token="access_token"

# 接口权限申请:

发送需要申请的接口到hongfuhuang@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com,leowyang@tencent.com,luishhuang@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 的获取参考获取应用有效凭证。