创建邮件组
创建邮件组
请求说明
| 请求地址 | https://openapi.wps.cn/v7/mail_groups |
|---|---|
| 请求方法 | POST |
| 签名方式 | KSO-1 |
| 权限要求 | 查询和管理邮件组信息（用户授权） kso.mail_group.readwrite |
请求头（Header）
| Header 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | 使用：application/json |
| X-Kso-Date | string | 是 | RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT |
| X-Kso-Authorization | string | 是 | KSO-1 签名值，详见《签名方法》 |
| Authorization | string | 是 | 授权凭证，格式为：Bearer {access_token} |
请求体（Body）
| 名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| accepted_type | string[enum] | 是 | 邮件组可发信范围类型 all：所有人；company：当前企业所有人；member：邮件组内成员；custom：自定义 |
| address | string | 是 | 地址，形如：user_name@domain |
| name | string | 是 | 名字 |
| owner_address | string | 是 | 邮件组负责人邮箱地址 |
请求地址示例
[POST] https://openapi.wps.cn/v7/mail_groups请求体示例
json
{
"accepted_type": "string[enum]",
"address": "string",
"name": "string",
"owner_address": "string"
}响应体
| 名称 | 参数类型 | 说明 |
|---|---|---|
| code | integer | 响应代码。非 0 表示失败，参照《状态码说明》 |
| msg | string | 响应信息 |
| data | object | 响应数据 |
| ∟ accepted_senders | array[object] | 允许往邮件组发信的成员列表，默认展示 10 条，allow_type 为 custom 时才有该字段 |
| ∟ ∟ avatar | string | 成员头像链接 |
| ∟ ∟ email_address | string | 成员邮箱地址 |
| ∟ ∟ name | string | 成员名字 |
| ∟ ∟ type | string[enum] | 成员类型 dept：部门；user：用户；mailbox：公共邮箱 |
| ∟ accepted_type | string[enum] | 邮件组可发信范围类型 all：所有人；company：当前企业所有人；member：邮件组内成员；custom：自定义 |
| ∟ address | string | 地址，形如：user_name@domain |
| ∟ id | string | id |
| ∟ members | array[object] | 邮件组成员列表，默认展示 10 条 |
| ∟ ∟ avatar | string | 成员头像链接 |
| ∟ ∟ email_address | string | 成员邮箱地址 |
| ∟ ∟ name | string | 成员名字 |
| ∟ ∟ type | string[enum] | 成员类型 dept：部门；user：用户；mailbox：公共邮箱 |
| ∟ name | string | 名字 |
| ∟ owner | object | 邮件组负责人 |
| ∟ ∟ avatar | string | 用户的头像链接 |
| ∟ ∟ email_address | string | 用户的邮箱地址 |
| ∟ ∟ name | string | 名字。创建，更新公共邮箱时无需提供 |
| more | object | 更多的错误信息 |
响应体示例
json
{
"code": 0,
"data": {
"accepted_senders": [
{
"avatar": "string",
"email_address": "string",
"name": "string",
"type": "string[enum]"
}
],
"accepted_type": "string[enum]",
"address": "string",
"id": "string",
"members": [
{
"avatar": "string",
"email_address": "string",
"name": "string",
"type": "string[enum]"
}
],
"name": "string",
"owner": {
"avatar": "string",
"email_address": "string",
"name": "string"
}
},
"msg": "string"
}