# 获取成员身份类型

# 接口描述

用于获取身份类型列表,对应用户的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": 4,
            "name": "教职工",
            "classification": 3,
            "classification_name": "教职工"
        },
        {
            "identity_type": 5,
            "name": "校友",
            "classification": 4,
            "classification_name": "校友"
        },
        {
            "identity_type": 6,
            "name": "本科生",
            "classification": 2,
            "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 其他 身份类型分类名称

# 注意事项

  1. 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
  2. access_token的获取参考获取应用有效凭证
  3. 身份类型列表需定时更新,推荐每日进行一次全量更新。
  4. 每个主体进行初始化时,默认会提供其他(0)、学生(1)、教职工(4)、校友(5)四种初始身份类型,主体方可以自行进行调整,其中"其他"身份类型无法删除。

# 更新日志

日期 变更说明
2019-10-22 新文档上线