中国电信qchat业务终端参数配置接口要求-系统和用户数据分册

中国电信 Qchat 业务终端参数配置接口技术要求 系统和用户数据分册 （征求意见稿） 中国电信股份有限公司广州研究院 二零 壹零 年 三 月 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 2 页 目录 1 范围 .3 1.1 文档更改历史 .3 2 缩略语 .5 3 管理终端数据配置文档的 XCAP 服务 .6 3.1 终端数据配置文档 .6 3.2 支持的 HTTP 方法 .6 3.3 支持的 HTTP 头 .6 3.3.1 适用于所有操作的头 .6 3.3.2 PUT 必须携带的头 .6 3.3.3 用于条件操作 HTTP 头 .7 3.4 终端数据配置服务器 XCAP 请求 URL.8 3.5 终端数据配置服务器器后向兼容对客户端 XML 解析的要求 .9 4 终端数据配置服务器 XCAP 接口规范 . 10 4.1 概述 . 10 4.2 正常响应 . 10 4.2.1 正常响应描述 . 10 4.3 错误响应 . 10 4.3.1 错误响 应描述 . 11 4.4 操作终端数据配置文档 . 15 4.4.1 Data Schema . 15 4.4.2 使用场景 . 18 5 终端数据配置服务器 短消息（ SMS）接口规范 . 28 5.1 TDCS 通知的短消息负荷 . 28 5.2 收到通知后如何产生获取用户配置文档 更新的 URL . 29 6 终端数据配置服务器客户端的配置信息 . 30 6.1 配置信息 . 30 6.2 主副地址切换建议 . 30 7 对手机终端和用户管理平台群组操作能力的建 议 . 31 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 3 页 1 范围 终端数据配置服务器 (Terminal Data Configuraiton Server: TDCS) 是用户终端配置数据管理和下发的 XML 文档管理服务器 .文档的管理操作包括新建 /读取 /修改 . 这些操作是通过 XCAP 接口完成的。终端数据配置服务器 (TDCS) 还提供数据下发给终端的能力。下发通知是通过短信实现的。 本文定义终端与终端数据配置服务器 (TDCS)进行通信时的接口规范。 本文用 TDCS 表示终端数据配置服务器。 1.1 文档更改历史 时间 说明 2009.2.12 以下为更改的主要内容： : 增加 content-type application/xcap-el+xml 3.4 : 增加对 FQDN 使用的解释 4.4.2: 修改示例消息中的几处错误。 .2: 增加使用 CR order 的注意事项 . 5.1 : 短消息负荷更改 5.2 : 终端获取 XUI 的方法更改 6.1 : 服务器故障转移定时参数取值修改 6.2 : 增加了主副地址切换的方法建议 7 : 增加了手机 UIM 卡更换的考虑 另外修改了一些文字错误。 2009.3.2 : 响应消息改为 201 Created. 并在 .1 中加入对已有 Call Restriction 替换的注释。 2009.7.14 5.1：修改 TDCS 采用 SMGP 协议 要求及流程 说明。 2009.8.5 5.1：修改 TDCS 发送的 为 ，以及针对的样例“ QCHAT”修改 为 “ PTT” 。 2009.8.5 修改配置信息更新流程图。 2009.8.31 1 4.4.1 的 data schema 中加入 xs:any 元素以备将来扩展 2. 文档 URI 示例中 改为 3. 文档示例中用户域名改为 2009.11.18 更正图 5-1 中的协议标识。 2009.11.23 修改文档中所有“ ”为“ ”。 2010.3.1 修改文档中所有“ ”为“ ”。 2010.3.25 修改文档中所有“ ”为“ sh.glms.vnet.mobi:9445”。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 4 页 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 5 页 2 缩略语 Term/Acronym Definition 3GPP 3rd Generation Partnership Project AUID Application Usage ID FQDN Fully Qualified Domain Name TDCS Terminal Data Configuration Server HTTP Hypertext Transfer Protocol IETF Internet Engineering Task Force OMA Open Mobile Alliance SMPP Short Message Peer-to-peer Protocol SMSC Short Message Service Center URI Uniform Resource Identifier URL Uniform Resource Locator XCAP XML Configuration Access Protocol XDM XML Document Management XDMC XML Document Management Client XDMS XML Document Management Server XML Extensible Markup Language XUI XCAP User Identity 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 6 页 3 管理终端数据配置文档的 XCAP 服务 3.1 终端数据配置文档 在 TDCS 中，存在用户终端配置文档，即适用于某一用户的终端配置文档。该文档包含该用户的终端进行 PTT 适用的配置信息。 3.2 支持的 HTTP 方法 TDCS支持以下 HTTP/XCAP操作 : HTTP GET （获取 用户配置文档 信息） HTTP PUT (新建 或修改 用户配置文档 ) HTTP DELETE （ 修改 用户配置文档中某些信息） 3.3 支持的 HTTP 头 3.3.1 适 用于 所有操作的头 用于认证的头 : ClientID “ClientID” 在每个 HTTP请求中都必须携带 . “ClientID” 可以被 WAP 网关或用户群组管理平台加入，并随请求消息送到 TDCS。 ClientID应该携带明文的用户 ID 信息。 TDCS 信任“ ClientID”所包含的用户 ID 就是请求发起者的用户 ID。 注意：运营商也可以选用其它的 HTTP 头作为用于认证的头，如： P-Asserted-Identity. 但所有的发送到 TDCS 的请求必须使用相同的头。 用于识别客户端协议版本的头 : GLMSClientVersion “GLMSClientVersion” 在每个 HTTP请求中都必须携带 . TDCS 客户端用 “GLMSClientVersion”表示它所实现的 TDCS 协议版本。对应于本规范，版本号应为“ 11.01” 注意：运营商也可以选用其它的 HTTP 头作为用于版本标识的头，如： GLMS-Group-Version. 但所有的发送到 TDCS 的请求必须使用相同的头。 3.3.2 PUT 必须携带的头 对 XCAP PUT 操作 , 下列 HTTP 头必须携带： “Content Type” 和 “Content Length”. 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 7 页 Content Type Content-Type 头域指定所包含的消息体的媒体类型。其格式 为 : Content-Type = Content-Type : media-type TDCS 中有效的 content type 为 : Content-Type: application/user-config+xml Content-Type: application/xcap-el+xml 在不同场景下的具体使用参见第 4 章。 Content Length Content-Length 头域指定消息体的长度 （ 8 位字节数）。其格式为： Content-Length = Content-Length : 1*DIGIT 例如 : Content-Length: 3495 3.3.3 用于条件操作 HTTP 头 HTTP 定义了几个可以被客户端用来做条件请求的头域： If-None-Match 和 If-Match。 客户端可以根据所请求资源的实体标签（ entity tag）来做条件请求 . 这些条件请求的头域在请求消息里是可选用的 . 条件请求的头域可以解决并发请求的冲突问题。 If-Match If-Match 请求头域被 HTTP 方法 (PUT/DELETE)用来做有条件操作 . 对一个或多个从群组服务器获得的实体， XDS 客户端可以在请求的 If-Match 头中包含某个实体的entity tag 以 确认它所具有的那个实体是最新的 . If-Match 头可以被用在以下场景中 : 条件 PUT XDM 客户端想增加或修改服务器 XDM 文档中的某个元素（ element），并且希望服务器所具有的文档版本和客户端当前所具有的那个文档相同时才能修改。客户端可以在请求中包含 If-Match 头 , 并将客户端所具有的实体标签（ entity tag）值写在里面 . 如果文档已 经改变，群组服务器会拒绝这个请求返回 412 （条件失败） . 在这种情况下，客户端需要重新用 GET 请求从服务器获取这个文档并保存服务器在 200 OK 中返回的新的实体标签（ entity tag）。 客户端可以把新的 实体标签（ entity tag）放在 If-Matc 头中 重新请求修改文档。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 8 页 如果操作成功， 响应消息的 etag 头会包含刚被修改过的资源的新的实体标签（ entity tag）。 条件 DELETE XDM 客户端也可以在 DELETE 请求中包含 If-Match 头来做条件删除 . DELETE 请求的 200 OK 响应会包含一个 etag 头域 , 带有所删除元素所在的整个文档的实体标签（ entity tag） If-None-Match If-None-Match请求头域可以和 GET请求方法一起使用做条件请求 . If-None-Match头中 可以包含客户端以前从服务器所获取的资源实体的 实体标签（ entity tag） 。 If-None-Match 头可以被用在以下场景中 : 条件 GET 当 XDM 客户端本地存有一个文档的版本，它可以做条件 GET 来判断服务器对统一文档是否有更新。如果本地文档仍然是最 新的，客户端就不会重新下载文档，以此节省网络的使用。为了达到这个目的，客户端在 GET 请求中携带 If-None-Match 头域，其中包含客户端当前文档的 实体标签（ entity tag） . 终端数据配置服务器 如果发现服务器文档标签和客户端不同，会响应 200 OK. 如果服务器文档标签和客户端相同 , 服务器会响应 304 Not Modified. 3.4 终端数据配置服务器 XCAP 请求 URL 1. XCAP 根节点 （ XCAP root） XCAP 根定义了所有可被请求的资源所在的位置 . XCAP 根用 HTTP URI 表示 , 被称为XCAP 根 RUI。对 终端数据配置服务器 XCAP 根 被定义为 /TDCS FQDN/tdcs-services/. 注：在具体构造 HTTP 请求时， TDCS FQDN 应该为 TDCS 服务器的地址，并且在发出HTTP 请求时放在 HOST HTTP 头中，而不是 Request-URI 中。另外，由于 TDCS 有主副地址， TDCS FQDN 可能是两个。（关于主副地址，请参见第 6 章） 2. 文档选择器 （ Document Selector） 在文档根节点下的每一个 XML 文档使用文档选择器 作为 唯一标识，文档选择器类似于由多个路径标识符组成的一个完整路径，使用“ /”作为路径分隔符 . 第一个路径部分必须是XCAP AUID。 终端数据配置服务器支持 以下 XCAP AUID: 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 9 页 USER-CONFIG: 用来进行群组的操作 在每个 AUID 下有两个子 XCAP 分支 . 一个称 为 “用户树”（“ user” tree） , 保存某个用户的终端配置文档“ index” 。 另一个分支是“全局树”（“ global” tree） , 保存适用于所有用户的 终端配置 文档 “ index” . AUID 之后的路径部分必须是 global 或 users. 每个用户对服务器而言都有一个用户名，被称为 XCAP 用户 标识符 （ XCAP User Identifier: XUI). 文档选择器余下的部分 (global 或 XUI 以后的路径 )指向具体的文档名 . 终端数据配置文件名为“ index”，并被保存在 users 树下。 3. 节点选择器 （ Node selector） 节点选择器指定 XML 文档中具体被操作的节点 . 节点选择器指向 XML 元素或元素属性 . 4. 产 生 TDCS 请求 URL 访问 终端数据配置服务器 的某个用户的 XML 文档 , 使用以下的 URL 格式 : http:/FQDN of TDCS server/service name/AUID/users/XUI of user/index 访问 TDCS 文档的 XML 元素，使用以下的 URL 格式 : document selector/node selector 3.5 终端数据配置服务器 器后向兼容对客户端 XML 解析的要求 这里的 终端数据配置服务器 客户端指所有与 TDCS 进行 HTTP/XCAP 通信客户端应用程序。 TDCS 会不断加入新的功能 . 群组管理的 XML schema 在将来可能会 被 扩展。 TDCS 升级到新的版本而客户端有可能仍然是旧的版本。为了使 TDCS 后向兼容， TDCS 客户端的实现必须要遵循以下建议 : o TDCS 客户端必须忽略服务器返回的合法的 XML 文档中不能识别的 XML 元素 或属性，而不是报错退出对文档的处理 . 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 10 页 4 终端数据配置服务器 XCAP 接口 规范 4.1 概述 TDCS 为客户端应用提供 XCAP 接口来管理服务器存储的 终端配置 XML 文档 . 客户端应用可以 新建 /读取 XML 文档及其 XML 元素和属性 . 本章给出 终端数据配置服务器 XCAP 接口规范。 4.2 正常响应 如果客户端的请求被成功处理， TDCS支持成功的 2xx 状态码： 状态码 描述 200 OK 201 Created 4.2.1 正常响应描述 200 (OK) 响应 当 XCAP GET/PUT/DELETE 请求被成功处理时返回 . 示例消息 : HTTP/1.1 200 OK etag: bcbcbc Content-Length: 0 . . . 201 (Created) 响应 当 XCAP PUT 请求被执行并其请求 的 resrouce 已经产生 . 示例消息 : HTTP/1.1 201 Created etag: ababab . . . Content-Length: 0 4.3 错误响应 XCAP 使用与 HTTP协议相同定义的错误响应状态码。 TDCS支持 3类错误状态码： 3xx, 4xx, 和 5xx. 3xx 是重定向状态码，指示客户端为满足请求去采取其它的行动。 4xx 是客户端错中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 11 页 误码，指出客户端请求可能包含的错误 . 5xx 是服务器错误码，指示服务器知道自己遇到问题而不能处理当前的请求。 状态码 描述 304 Not Modified 400 Bad Request 403 Forbidden 404 Not Found 405 Method Not Allowed 409 Conflict 412 Precondition Failed 415 Unsupported Media Type 500 Internal Server Error 503 Service Unavailable Error 4.3.1 错误响应描述 304 (Not Modified) 响应 在条件 GET 中使用 . 客户端在 If-None-Match 头中包含的 etag 与服务器所具有的该文档 etag相同 响应消息示例 : HTTP/1.1 304 Not Modified Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 403 (Forbidden) 响应 可以对 XCAP GET/PUT/DELETE 操作响应 . TDCS 不能处理该请求 ， 尽管理解该请求。 TDCS 可能携带请求被拒绝的原因在 403 响应 的“ reason-phrase” 中。 响应消息示例 : HTTP/1.1 403 Forbidden. The request is not allowed since the associated feature is locked. Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 400 (Bad Request) 响应 可以对 XCAP GET/PUT/DELETE 操作响应。由于语法错误 TDCS 不能理解该请求 . 响应消息示例 : HTTP/1.1 400 Bad Request Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 12 页 404 (Not Found) 响应 可以对 XCAP GET/PUT/DELETE 操作响应 . TDCS 不能找到被请求的资源。 响应消息示例 : HTTP/1.1 404 Not Found Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 405 (Method Not Allowed) 响应 可以对 XCAP 请求 响应 . TDCS 理解请求的方法但是不支持该操作 响应消息示例 : HTTP/1.1 405 Method Not Allowed Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 409 (Conflict) 响应 可以对 XCAP GET/PUT/DELETE 操作响应。请求因对当前资源的冲突而不能完成。 409 响应可携带 XML 消息体来指定冲突的具体原因。 以下是 409 响应中所包含的 “xcap-error” data schema. “xcap-error” 可以用来给出具体冲突原因。客户端应该支持以下 schema： 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 13 页 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 14 页 响应消息示例 : HTTP/1.1 409 Conflict Content-Type: application/xcap-error+xml Content-Length: xxxxx 412 (Precondition Failed) 响应 可以对 XCAP GET/PUT/DELETE 操作响应。 客户端可以携带 If-Match 头域来包含客户端所具有的 etag. 如果文档在服务器中已改变， 412 就会被返回 . 响应消息示例 : HTTP/1.1 412 Precondition Failed Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 415 (Unsupported Media Type) 响应 可以对 XCAP GET/PUT/DELETE 操作响应。 终端数据配置服务器 不接受请求消息中的内容编码。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 15 页 响应消息示例 : HTTP/1.1 415 Unsupported Media Type Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 500 (Internal Server Error) 响应 可以对 XCAP GET/PUT/DELETE 操作响应 . 终端数据配置服务器 遇到不可预料的情况不能完成请求 . 响应消息示例 : HTTP/1.1 500 Internal Server Error Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 0 503 (Service Unavailable) 响应 可以对 XCAP GET/PUT/DELETE 操作响应 . 终端数据配置服务器 因过载或维护等原因暂时不能处理请求 . 响应消息示例 : HTTP/1.1 503 Service Unavailable Content-Type: text/plain; charset=ISO-8859-1 Content-Length: 0 4.4 操作 终端数据配置 文档 4.4.1 Data Schema TDCS 支持以下终端数据配置文档 schema。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 16 页 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 17 页 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 18 页 4.4.2 使用场景 场景总结 创建 /替换用户终端数据配置 文档 查询用户终端数据配置文档 增加 Call Restriction 删除 Call Restriction 查询和更新用户其它配置参数 创建 /替换用户终端数据配置 文档 .1. 概述 该操作用来创建 /替换适用于某 用户的 终端数据配置 文档 . 只有系统管理员可以创建 /替换用户的终端配置文档。 成功的 XCAP PUT 操作会返回 201 Created 响应 （创建文档）或 200 OK 响应 （替换文档） . 失败的操作会返回 403 (Forbidden), 404 (Not Found) , 409 (Conflict) 或 412 (Precondition Failed)。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 19 页 .2. 用例 A d m i n T D C S1 . X C A P P U T2 . a 201 C r e a t e d2 . b 403 / 404 / 409 / 412图 4-1 管理员创建用户终端书记配置文档 1. 管理员创建一个用户终端数据配置文档 。它发起一个 XCAP PUT 请求 请求消息 : PUT http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index HTTP/1.1 . . . ClientID: requestors XUI Content-Type: application/user-config+xml Content-Length: xxxxx document content 请求消息示例 : 创建不含 Call Restrictions 的配置文件 PUT http:/sh.glms.vnet.mobi:9445/tdcs-services/user-config/users/4600013311111111111PTT.189.cn/index HTTP/1.1 . . . ClientID: systemadmPTT.189.cn Content-Type: application/user-config+xml Content-Length: xxxxxTT.189.cn 0280 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 20 页 true false 请求消息示例 : 创建含 Call Restrictions 的配置文件 PUT http:/sh.glms.vnet.mobi:9445/tdcs-services/user-config/users/4600013311111111111PTT.189.cn/index HTTP/1.1 . . . ClientID: systemadmPTT.189.cn Content-Type: application/user-config+xml Content-Length: xxxxxTT.189.cnTT.189.cn 0 1 1 1 1 0 0280 true false 2.a TDCS 接受请求返回 201 Created. 2.b TDCS 拒绝请求返回 403/404/409/412 错误响应，并包含详细的错误信息 响应消息 : HTTP/1.1 201 Created . . . etag: etag number Content-Length: 0 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 21 页 响应消息示例 : HTTP/1.1 201 Created . . . etag: ababab Content-Length: 0 查询用户终端数据配置文档 .1. 概述 该操作用来从“用户树”下获取用户 终端数据配置 文档 . XCAP GET 请求的响应消息包含详细的文档 信息 . 某用户可以获取自己的用户终端配置文档。系统管理员可以获取所有用户的终端配置文档。 终端也要利用该操作获取创建或更新的配置信息。 成功的 XCAP GET 操作会返回 200 OK 响应，并包含群组信息 . 失败的操作会返回 304 (Not Modified ), 403 (Forbidden) 或 404 (Not Found)等。 .2. 用例 A d m i n T D C S1 . X C A P G E T2 . a 200 OK2 . b 304 / 403 / 404图 4-2 管理员得到一个终端数据配置文档 1. 管理员 要得到一个用户 的终端配置 文档。它发起 XCAP GET 请求 请求消息 : GET http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index HTTP/1.1 . . . If-None-Match: etag number 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 22 页 ClientID: requestors XUI Content-Length: 0 请求消息示例 : GET http:/sh.glms.vnet.mobi:9445/tdcs-services/user-config/users/4600013311111111111PTT.189.cn/index HTTP/1.1 . . . If-None-Match: ababab ClientID: systemadmPTT.189.cn Content-Length: 0 2.a TDCS 接受 XCAP GET 请求返回 200 OK 响应，并包含 配置 信息 2.b TDCS 拒绝请求返回 304/403/404 错误响应，并包含详细的错误信息 响应消息 : HTTP/1.1 200 OK etag: etag number Content-Type: application/user-config+xml Content-Length: xxxxx . . . document content 响应消息示例 : HTTP/1.1 200 OK etag: bcbcbc Content-Type: application/vnd.oma.poc.groups+xml Content-Length: xxxxxTT.189.cnTT.189.cn 0 1 1 1 1 0 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 23 页 0280 true false 增加 Call Restriction .1. 概述 该操作可以用来 修改 终端数据配置文档 增加 Call Restriction。 XCAP PUT 被使用。请求消息中携带新的 Call Restriction。 只有系统管理员可以发起此操作。 成功的 XCAP PUT 操作返回 201 Created 响应 . 失败的操作会返回 403 (forbidden), 404 (not found)， 409 (conflict)和 412 (Precondition Failed)。 注：增加的 Call Restriction 是由 cr-order 来唯一标识的 。如果新加的 Call Restriction 的 cr-order 在文档中已经存在，本操作会变 成对已有 Call Restriction 的替换，如果成功会返回200 OK. .2. 用例 A d m i n T D C S1 . X C A P P U T2 . a 20 12 . b 403 / 404 / 409 / 412图 4-3 管理员增加某一用户的 call restrictions 配置信息 1. 管理员想增加某一用户的 Call Restriction 配置信息，发起一个 XCAP PUT 请求 注意：发起的请求 URI 中，必须指定新的 Call Restriction 的 CR-order. CR-order 表示该Call Restriction 的顺序，它必须与已有 Call Restriction 的 CR-order 不同。否则， TDCS认为这是对已有 Call Restriction 的替换。 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 24 页 请求消息： PUT http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index/user-config/carrier-level-call-restrictions/call-restrictioncr-order=”CR Order Attribute Value” HTTP/1.1 . . . If-Match: etag number ClientID: requestors XUI Content-Type: application/xcap-el+xml Content-Length: xxxxx document content 请求消息示例 : PUT http:/sh.glms.vnet.mobi:9445/tdcs-services/user-config/users/4600013311111111111PTT.189.cn/index/user-config/carrier-level-call-restrictions/call-restrictioncr-order=”3” HTTP/1.1 . . . If-Match: abcde ClientID: systemadmPTT.189.cn Content-Type: application/xcap-el+xml Content-Length: xxxxx * 1 1 0 2.a TDCS 接受请求返回 201 Created. 2.b TDCS 拒绝请求返回 403/404/409/412 错误响应，并包含详细的错误信息 响应消息： HTTP/1.1 201 Created . . . etag: etag number Content-Length: 0 响应消息示例 : HTTP/1.1 201 Created . . . etag: ababab Content-Length: 0 中国电信 qchat 业务终端参数配置接口技术要求 -系统和用户数据分册 第 25 页 删除 Call Restriction .1. 概述 该操作可以用 来 修改 终端数据配置文档 删除 Call Restriction。 XCAP DELETE 被使用。 只有系统管理员可以发起此操作。 成功的 XCAP DELETE 操作返回 200 OK 响应 .