ICS 33.030 CCS M21 YD 中华人民共和国 通信行业标准 YD/T XXXX —XXXX 基于表述性状态转移（ REST）技术的业务 能力开放应用程序接口（ API）邮件业务 RESTful based service capability open API—Email （报批稿） XXXX - XX - XX发布 XXXX - XX - XX实施 中华人民共和国工业和信息化部   发 布 I 目 次 前 言 ............................................................................................................................................................ II 1 范围 ....................................................................................................................................................... 1 2 规范性引用文件 ................................................................................................................................ 1 3 术语、定义和缩略语 ....................................................................................................................... 1 3.1 术语和定义 ................................................................................................................................. 1 3.2 缩略语 .......................................................................................................................................... 2 4 邮件业务概述 .................................................................................................................................... 2 5 邮件业务 API定义 ............................................................................................................................ 2 5.1 概述 ............................................................................................................................................... 2 5.2 资源概述 ...................................................................................................................................... 3 5.3 数据类型 ...................................................................................................................................... 6 6 资源详细定义 .................................................................................................................................. 11 6.1 通用要求 ................................................................................................................................... 11 6.2 用户接口 ................................................................................................................................... 12 6.3 标签接口 ................................................................................................................................... 25 6.4 草稿接口 ................................................................................................................................... 32 6.5 邮件夹接口 ............................................................................................................................... 41 6.6 附件接口 ................................................................................................................................... 49 6.7 电子邮件接口 .......................................................................................................................... 54 7安全要求 ............................................................................................................................................ 78 7.1 认证和授权 ............................................................................................................................... 78 7.2 API访问权限和频率控制 ...................................................................................................... 78 附 录 A ............................................................................................................................................. 79 II 前 言 本文件按照 GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规 则》的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国通信标准化协会提出和归口。 本文件起草单位：西安交通大学、中国电信集团有限公司 本文件主要起草人 ：曲桦、赵季红、李金艳、吴彤、杨峰义、张彦鹏、边江、刘伟、张 斌 1 基于表述性状态转移（ REST）的业务能力开放应用程序接 口（API）邮件业务 1 范围 本文件规定了基于表述性状态转移（ REST）技术实现邮件业务的开放应用程序接口 （API），包括接口的资源定义、资源操作、数据结构和安全要求等。 本文件适用于提供邮件业务能力开放的应用程序接口（ API）的研发、测试