ICS 33.040 YD M21 中华人民共和国通信行业标准 YD/T 3188-—2016 基于表述性状态转移（REST）技术的业务 能力开放应用程序接口（API） 文件传输业务 RESTful based service capability open API--File transfer (OMA-TS-REST NetAPI FileTransfer-V1 0-20140218-D , RESTful Network API File Transfer v1.0,NEQ) 2016-10-22 发布 2017-01-01实施 中华人民共和国工业和信息化部 发布 YD/T3188—2016 目 次 前言 1范围.. 2规范性引用文件， 3术语、定义和缩略语. 2 3.1术语和定义 2 3.2缩略语.. 4文件传输业务概述 3 5文件传输RESTfulAPI定义 3 5.1资源概述 5.2枚举类型定义..…. 5.3 数据结构定义. 5.4流程图. 10 接口定义， 6 12 6.1文件传输订阅管理， 6.2 创建一对一文件传输.. .15 6.3 查询和释放一对一文件传输， 20 6.4 被叫文件传输请求状态.. .23 6.5 被叫收到文件传输通知. 主叫侧文件传输接受通知.. 6.6 29 通知文件传输内容链接 6.7 .31 6.8 文件传输结束通知 .33 7错误定义 .36 7.1业务异常. ..36 7.2策略异常. .36 8授权框架. .36 8.1使用Autho4API框架， .36 8.2‘acr:auth'的用法.. 参考文献.. .37 YD/T3188—2016 前言 本标准是“基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）”系列标准 之一，该系列标准的结构及名称预计如下： 基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）短消息和多媒体 消息业务部分； 基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 点击拨号； 终端状态； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）终端能力信息； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 微博业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 搜索业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） ）地址本； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）文件传输业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）定位业务； 基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 状态呈现业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） ）聊天业务； 基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）用户信息业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 支付业务； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 视频共享； 一基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 图片共享； 基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 移动互联网用户 上下文感知业务； 据业务。 随着技术和市场的发展，还将根据情况制定后续相关标准。 本标准按照GB/T1.1-2009给出的规则起草。 本标准使用重新起草法参考OMA-TS-REST_NetAPI_FileTransfer-V1_0-20140218-D.《基于表述性 状态转移（REST）技术的文件传输应用程序接口（API）（OMARESTfulNetworkAPIFileTransfer v1.0）》编制，本标准与OMA-TS-REST_NetAPI_FileTransfer-V1_0-20140218-D的一致性程度为非等效。 本标准由中国通信标准化协会提出并归口。 本标准起草单位：中国移动通信集团公司、中国信息通信研究院、中国联合网络通信集团有限公 司、中国电信集团公司。 本标准主要起草人：刘悦、庞亚昆、杨波、赵婷、汪洋。 II