# 获取成员身份类型
# 接口描述
用于获取身份类型列表,对应用户的idenity_type字段
# 请求方法
POST(application/json)
# 请求地址
https://open.wecard.qq.com/cgi-bin/user/get-identity-type?access_token=access_token
# 参数说明
参数 | 必填 | 类型 | 实例 | 说明 |
---|---|---|---|---|
access_token | 是 | String | 应用凭证 |
# 响应说明
{
"errcode": 0,
"errmsg": "ok",
"list": [
{
"identity_type": 0,
"name": "其他",
"classification": 1,
"classification_name": "其他"
},
{
"identity_type": 1,
"name": "员工",
"classification": 2,
"classification_name": "员工"
},
{
"identity_type": 2,
"name": "学生",
"classification": 3,
"classification_name": "学生"
},
{
"identity_type": 3,
"name": "教职工",
"classification": 4,
"classification_name": "教职工"
}
]
}
参数 | 必填 | 类型 | 实例 | 说明 | |
---|---|---|---|---|---|
errcode | 是 | Integer | 0 | 状态码,0为成功,非0为错误 | |
errmsg | 是 | String | success | 状态描述信息 | |
list | identity_type | 是 | Integer | 0 | 身份类型id |
name | 是 | String | 其他 | 身份类型名称 | |
classification | 是 | Integer | 1 | 身份类型分类id | |
classification_name | 是 | String | 其他 | 身份类型分类名称 |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
- access_token的获取参考获取应用有效凭证。
- 身份类型列表需定时更新,推荐每日进行一次全量更新。
- 每个主体进行初始化时,默认会提供其他(0)、学生(1)、教职工(4)、校友(5)四种初始身份类型,主体方可以自行进行调整,其中"其他"身份类型无法删除。
# 更新日志
日期 | 变更说明 |
2019-10-22 | 新文档上线 |