添加公共账号
使用场景： 调用本接口，新增一个新的公共账号。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/public_account/add
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nickname | string | 是 | 公共账号昵称 |
| password | string | 是 | 公共账号密码，MD5加密（32位小写）两次，如："abc" MD5两次以后的值为 "ec0405c5aef93e771cd80e0db180b88b" |
| department_ids | []uint32 | 是 | 公共账号所属的部门id列表 |
| account | string | 是 | 公共账号，可用于登录 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码，0为正常 |
| errmsg | string | 对返回码的文本描述内容 |
| userid | string | 公共账号的用户id |
请求示例：
POST https://test-oapi.epaas.qq.com/public_account/add?access_token=ACCESS_TOKEN
请求包体：
{
"nickname": "张三",
"password": "ec0405c5aef93e771cd80e0db180b88b",
"department_ids": [
123,
456
],
"account": "公共访客账号"
}
返回示例：
{
"errcode": 0,
"errmsg": "ok",
"userid": "886"
}
修改公共账号
使用场景： 调用本接口，修改一个公共账号的信息的昵称、登录账号或者所属部门。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/public_account/update
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 公共账号的用户id |
| nickname | string | 是 | 公共账号昵称 |
| department_ids | []uint32 | 是 | 公共账号所属的部门id列表 |
| account | string | 是 | 公共账号，可用于登录 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码，0为正常 |
| errmsg | string | 对返回码的文本描述内容 |
请求示例：
POST https://test-oapi.epaas.qq.com/public_account/update?access_token=ACCESS_TOKEN
请求包体：
{
"userid":"886",
"nickname": "李四",
"department_ids": [
456,
789
],
"account": "外部访客账号"
}
返回示例：
{
"errcode": 0,
"errmsg": "ok"
}
删除公共账号
使用场景： 调用本接口，删除一个公共账号。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 不需要 | |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/public_account/delete
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| userid | string | 是 | 公共账号的用户id |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码，0为正常 |
| errmsg | string | 对返回码的文本描述内容 |
请求示例：
POST https://test-oapi.epaas.qq.com/public_account/delete?access_token=ACCESS_TOKEN
请求包体：
{
"userid": "886"
}
返回示例：
{
"errcode": 0,
"errmsg": "ok"
}