1. 域名邮箱
邮箱服务
  • 邮件接收服务 API 文档说明
  • 新版本v2的接口
    • 用户端接口
      • 域名邮箱
        • 验证用户密钥
          GET
        • 获取活跃域名列表
          GET
        • 获取用户邮箱列表
          GET
        • 生成随机邮箱 (GET方法)
          GET
        • 生成随机邮箱
          POST
        • 批量生成随机邮箱 (GET方法)
          GET
        • 批量生成随机邮箱
          POST
        • 绑定自定义域名 (GET方法)
          GET
        • 绑定自定义域名
          POST
        • 导出邮箱地址列表
          GET
        • 获取邮箱邮件列表
          GET
        • 获取未读邮件列表
          GET
        • 获取邮件详情
          GET
        • 获取文档配置
          GET
        • 设置邮箱备注
          PUT
        • 检查域名绑定权限
          GET
        • 获取用户绑定域名列表
          GET
        • 更新用户域名
          PUT
        • 删除用户域名
          DELETE
        • 批量删除用户域名
          POST
        • 聚合未读邮件列表
          GET
        • 批量设置邮箱公开配置
          PUT
        • 设置邮箱公开配置
          PUT
        • 获取邮箱公开配置
          GET
        • 批量获取邮箱公开配置
          POST
        • 公开访问邮箱最新邮件
          GET
        • 批量获取指定邮箱最新邮件
          POST
        • 清空指定邮箱的全部邮件
          DELETE
        • 获取未读邮件列表
          GET
        • 创建清空全部邮件任务
          POST
        • 获取最近一次清空任务
          GET
      • 微软邮箱
        • 公开邮箱相关
          • 微软邮箱公开邮件列表
          • 微软邮箱-批量设置公开配置
          • 微软邮箱-设置单个公开配置
          • 微软邮箱-获取单个公开配置
          • 微软邮箱-批量获取公开配置
        • 微软邮箱-已获取的微软邮箱列表
        • 微软邮箱-获取邮件
        • 微软邮箱-已分配账号四段式列表
        • 微软邮箱-单账号四段式信息
        • 微软邮箱-设置账号备注
        • 微软邮箱-获取微软邮箱-支持批量
        • 微软邮箱-导出邮箱地址
    • 自提端
      • 自提客户-摘要信息
      • 自提客户-订单列表
      • 自提客户-创建订单
      • 自提客户-订单详情
      • 自提客户-订单子秘钥列表
      • 自提客户-子秘钥列表
      • 自提客户-注销子秘钥
      • 自提客户-启用子秘钥
      • 自提客户-收窄子秘钥权限
      • 自提客户-导出子秘钥邮箱
      • 自提客户-预览子秘钥额度调整
      • 自提客户-执行子秘钥额度调整
      • 兑换充值卡密
    • 获取服务基本信息
      GET
    • 注销当前登录密钥
      POST
    • 公开访问-获取邮箱公开配置
      GET
    • 公开访问-获取邮箱邮件列表
      GET
    • 公开访问-获取指定邮件详情
      GET
    • 微软邮箱公开访问-获取公开配置
      GET
    • 微软邮箱公开访问-获取最新邮件
      GET
    • 获取最新已发布公告
      GET
    • 验证用户密钥
      GET
    • 获取公告历史列表
      GET
    • 获取活跃域名列表
      GET
    • 获取公告详情
      GET
    • 获取用户邮箱列表
      GET
    • 标记公告已读
      POST
    • 生成随机邮箱
      POST
    • 提交用户反馈
      POST
    • 获取邮箱邮件列表
      GET
    • 额度置换
      POST
    • 获取邮件详情
      GET
    • 获取服务基本信息
      GET
    • 按 ID 获取清空任务详情
      GET
    • 批量设置邮箱公开配置
      POST
    • 获取教程文档链接
      GET
    • 更新教程文档链接
      POST
    • 按订单返还并注销子秘钥
      POST
    • 微软邮箱-全局账号列表
      GET
    • 微软邮箱-批量删除账号
      POST
    • 微软邮箱-直接导入账号
      POST
    • 微软邮箱-创建导入任务
      POST
    • 微软邮箱-导入任务列表
      GET
    • 微软邮箱-导入任务详情
      GET
    • 微软邮箱-上传导入任务分片
      POST
    • 微软邮箱-提交导入任务
      POST
    • 微软邮箱-导入任务日志
      GET
    • 微软邮箱-账号统计
      GET
    • 微软邮箱-统计快照列表
      GET
    • 微软邮箱-创建验证任务
      POST
    • 微软邮箱-验证任务列表
      GET
    • 微软邮箱-验证任务详情
      GET
    • 微软邮箱-验证任务日志
      GET
    • 微软邮箱-创建刷新令牌任务
      POST
    • 微软邮箱-刷新令牌任务列表
      GET
    • 微软邮箱-刷新令牌任务详情
      GET
    • 微软邮箱-刷新令牌任务日志
      GET
  • 旧版v1的接口
    • 获取服务基本信息
    • 验证用户密钥
    • 获取活跃域名列表
    • 获取用户邮箱列表
    • 生成随机邮箱
    • 获取邮箱邮件列表
    • 获取未读邮件列表
    • 获取邮件详情
    • 获取服务基本信息
  • 获取最新已发布公告
    GET
  • 获取公告历史列表
    GET
  • 获取公告详情
    GET
  • 标记公告已读
    POST
  • 提交用户反馈
    POST
  • 额度置换
    POST
  • 创建清空全部邮件任务
    POST
  • 获取最近一次清空任务
    GET
  • 按 ID 获取清空任务详情
    GET
  • 批量设置邮箱公开配置
    POST
  • 获取教程文档链接
    GET
  • 更新教程文档链接
    POST
  • 兑换充值卡密
    POST
  • 按订单返还并注销子秘钥
    POST
  • 数据模型
    • Schemas
    • Response
    • Mailbox
    • Domain
    • TooManyRequests
    • EmailSummary
    • MailboxDetail
    • EmailDetail
    • MailboxListResponse
    • EmailListResponse
    • Error
    • RateLimitError
    • PublicViewMode
    • PublicMailboxConfig
    • MailboxPublicStatusItem
    • MsAccountPublicStatusItem
    • PublicMailboxMessageListData
    • MsPublicMessage
    • SimpleSuccessResponse
    • MailboxPublicConfig
    • MailboxPublicConfigUpdateRequest
    • BatchMailboxPublicUpdateResponse
    • BatchMailboxPublicStatusItem
    • PublicMailboxMetaResponse
    • PublicMailboxMessagesResponse
    • PublicMailboxLatestResponse
    • ClearMailboxEmailsResponse
    • MsAccountPublicConfig
    • MsAccountBatchPublicUpdateResponse
    • MsAccountBatchPublicStatusItem
    • SelfPricingLevel
    • SelfSummaryData
    • SelfOrder
    • SelfCreatedKey
    • SelfOrderKey
    • SelfQuotaAdjustmentDetail
    • SelfQuotaAdjustmentData
  1. 域名邮箱

更新用户域名

PUT
http://email2.ymb1668.com/api/v2/user/domains/{id}
最后修改时间:2026-04-29 09:29:36
更新指定域名配置

请求参数

Authorization
API Key
在 header 添加参数
X-API-Key
示例:
X-API-Key: ********************
or
Path 参数

Body 参数application/json

示例
{
    "description": "客户端绑定域名"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://email2.ymb1668.com/api/v2/user/domains/1' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "客户端绑定域名"
}'

返回响应

🟢200成功
application/json
更新域名成功
Bodyapplication/json

示例
{
    "success": true,
    "domain": {
        "id": 1,
        "domain_name": "example.com",
        "is_active": true,
        "description": "示例域名",
        "user_key_id": 1,
        "created_at": "2019-08-24T14:15:22.123Z",
        "expires_at": "2027-03-08 00:00:00",
        "remaining_days": 240,
        "random_eligible": true,
        "hard_disabled": false,
        "status": "active",
        "tags": [
            "中文站",
            "回收"
        ],
        "user_key_value": "user-abc123"
    }
}
🟠400请求有误
🟠429请求过多
修改于 2026-04-29 09:29:36
上一页
获取用户绑定域名列表
下一页
删除用户域名
Built with