接口描述
新增用户,若用户已存在,则进行更新。
请求方法
POST(application/json)
请求地址
https://open.wecard.qq.com/cgi-bin/user/manage/create?access_token="access_token"
输入参数
参数名称 | 是否必填 | 参数类型 | 示例 | 参数描述 |
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 | 备注 |
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 | 仙桃市郑场镇潘阳村八组 | 住址 |
school_period | 否 | String | 幼儿园 | 学段 |
register_year | 否 | int | 2022 | 入学年份 |
输出参数
参数名称 | 参数描述 | 参数类型 | 是否必填 |
errcode | 响应状态码 | Integer | 是 |
errmsg | 响应状态信息 | String | 是 |
示例
输入示例
{"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":"仙桃市郑场镇潘阳村八组","school_period":"幼儿园","register_year":"2022"}
输出示例
{"errcode":0,"errmsg":"OK"}