# 创建个人邮箱
用于员工入职时进行个人邮箱的创建
# 请求
| 基本 | |
|---|---|
| HTTP URL | https://hi-gw.weizhipin.com/open-apis/mail/v1/user_mailboxes |
| HTTP Method | POST |
| 支持的应用类型 | 自建应用 |
| 权限要求 | [邮箱]-[创建/更改个人邮箱] |
# 请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token"示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" |
| Content-Type | string | 是 | 固定值："application/json; charset=utf-8" |
# 请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| mailbox_address | string | 是 | 示例值 zenglinhong@kanzhun.com需要带上邮箱后缀 邮箱地址格式错误会报错 邮箱已存在会报错 |
| mailbox_name | string | 是 | 邮箱名称 |
# 请求体示例
{
"mailbox_address": "zenglinhong@kanzhun.com",
"mailbox_name": "曾林泓"
}
1
2
3
4
2
3
4
# 响应
# 响应体
| 名称 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码，非 0 表示失败 |
| msg | string | 调用描述 |
| data | boolean | - |
| success | boolean | 请求是否成功 |
| trace_id | string | 链路id |
# 响应体示例
{
"code": 0,
"traceId": "_Ao59UOIBLPCeAAu",
"success": true,
"data": true,
"msg": "操作成功"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
如果响应非成功状态，请对照 错误码文档