qchat业务终端参数配置接口要求-系统和用户数据分册v1.6

1、中国电信中国电信 QchatQchat 业务终端参数配置接口技术要求业务终端参数配置接口技术要求系统和用户数据分册系统和用户数据分册（征求意见稿）（征求意见稿）中国电信股份有限公司广州研究院中国电信股份有限公司广州研究院中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 2页二零零九年十一月二零零九年十一月目录目录1 1范围范围.3 31.1文档更改历史.32 2缩略语缩略语.4 43 3管理终端数据配置文档的管理终端数据配置文档的 XCAPXCAP 服务服务.5 53.1终端数据配置文档.53.2支持的 HTTP 方法.53.3支持的 HTTP 头.53.3.1适用于所

2、有操作的头.53.3.2PUT 必须携带的头 .53.3.3用于条件操作 HTTP 头.63.4终端数据配置服务器 XCAP 请求 URL .73.5终端数据配置服务器器后向兼容对客户端 XML 解析的要求.84 4终端数据配置服务器终端数据配置服务器 XCAPXCAP 接口规范接口规范 .9 94.1概述.94.2正常响应.94.2.1正常响应描述.94.3错误响应.94.3.1错误响应描述.104.4操作终端数据配置文档.144.4.1 Data Schema.144.4.2使用场景.175 5终端数据配置服务器短消息（终端数据配置服务器短消息（SMSSMS）接口规范）接口规范.26265

3、.1TDCS 通知的短消息负荷 .265.2收到通知后如何产生获取用户配置文档更新的 URL .276 6终端数据配置服务器客户端的配置信息终端数据配置服务器客户端的配置信息.28286.1配置信息.286.2主副地址切换建议.287 7对手机终端和用户管理平台群组操作能力的建议对手机终端和用户管理平台群组操作能力的建议.2929中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 3页1 1范围范围终端数据配置服务器(Terminal Data Configuraiton Server: TDCS) 是用户终端配置数据管理和下发的 XML 文档管理服务器.文档的管理操作包

4、括新建/读取/修改. 这些操作是通过 XCAP 接口完成的。终端数据配置服务器(TDCS) 还提供数据下发给终端的能力。下发通知是通过短信实现的。本文定义终端与终端数据配置服务器(TDCS)进行通信时的接口规范。本文用 TDCS 表示终端数据配置服务器。1.11.1文档更改历史文档更改历史时间时间说明说明2009.2.12以下为更改的主要内容：: 增加 content-type application/xcap-el+xml3.4 : 增加对 FQDN 使用的解释4.4.2: 修改示例消息中的几处错误。.2: 增加使用 CR order 的注意事项.5.1 : 短消

5、息负荷更改5.2 : 终端获取 XUI 的方法更改 6.1 : 服务器故障转移定时参数取值修改6.2 : 增加了主副地址切换的方法建议7 : 增加了手机 UIM 卡更换的考虑另外修改了一些文字错误。200.2.4: 响应消息改为 201 Created. 并在 .1 中加入对已有 Call Restriction 替换的注释。200：修改 TDCS 采用 SMGP 协议要求及流程说明。200：修改 TDCS 发送的为，以及针对的样例“QCHAT”修改为“PTT”。2009.8.5修改配置信息更新流程图。2009.8.3114.4.

6、1 的 data schema 中加入 xs:any 元素以备将来扩展2. 文档 URI 示例中 改为3. 文档示例中用户域名改为 PTT2009.11.18更正图 5-1 中的协议标识。中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 4页2 2缩略语缩略语Term/AcronymTerm/AcronymDefinitionDefinition3GPP3rd Generation Partnership ProjectAUIDApplication Usage IDFQDNFully Qualified Domain NameTDCSTerminal Data Con

7、figuration ServerHTTPHypertext Transfer ProtocolIETFInternet Engineering Task ForceOMAOpen Mobile AllianceSMPPShort Message Peer-to-peer ProtocolSMSCShort Message Service CenterURI Uniform Resource IdentifierURLUniform Resource LocatorXCAPXML Configuration Access ProtocolXDMXML Document ManagementXD

8、MCXML Document Management ClientXDMSXML Document Management ServerXMLExtensible Markup LanguageXUIXCAP User Identity中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 5页3 3管理终端数据配置文档管理终端数据配置文档的的 XCAPXCAP 服务服务3.13.1终端数据配置文档终端数据配置文档在 TDCS 中，存在用户终端配置文档，即适用于某一用户的终端配置文档。该文档包含该用户的终端进行 PTT 适用的配置信息。3.23.2支持的支持的 HTTPHTTP

9、方法方法TDCS 支持以下 HTTP/XCAP 操作:HTTP GET （获取用户配置文档信息）HTTP PUT (新建或修改用户配置文档)HTTP DELETE （修改用户配置文档中某些信息）3.33.3支持的支持的 HTTPHTTP 头头3.3.1适用于所有操作的头用于认证的头: ClientID“ClientID” 在每个HTTP请求中都必须携带. “ClientID” 可以被 WAP 网关或用户群组管理平台加入，并随请求消息送到TDCS。ClientID 应该携带明文的用户 ID 信息。TDCS 信任“ClientID”所包含的用户 ID就是请求发起者的用户 ID。 注意

10、：运营商也可以选用其它的 HTTP 头作为用于认证的头，如：P-Asserted-Identity. 但所有的发送到 TDCS 的请求必须使用相同的头。用于识别客户端协议版本的头: GLMSClientVersion“GLMSClientVersionGLMSClientVersion” 在每个HTTP请求中都必须携带. TDCS 客户端用“GLMSClientVersionGLMSClientVersion”表示它所实现的 TDCS 协议版本。对应于本规范，版本号应为“11.01”注意：运营商也可以选用其它的 HTTP 头作为用于版本标识的头，如：GLMS-Group-Vers

11、ion. 但所有的发送到 TDCS 的请求必须使用相同的头。3.3.2 PUT 必须携带的头对 XCAP PUT 操作 , 下列 HTTP 头必须携带：“Content Type” 和 “Content Length”. 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 6页Content TypeContent-Type 头域指定所包含的消息体的媒体类型。其格式为:Content-Type = Content-Type : media-typeTDCS 中有效的 content type 为:Content-Type: application/user-

12、config+xmlContent-Type: application/xcap-el+xml在不同场景下的具体使用参见第 4 章。Content LengthContent-Length 头域指定消息体的长度 （8 位字节数）。其格式为：Content-Length = Content-Length : 1*DIGIT例如: Content-Length: 34953.3.3用于条件操作 HTTP 头HTTP 定义了几个可以被客户端用来做条件请求的头域：If-None-Match 和 If-Match。 客户端可以根据所请求资源的实体标签（entity tag）来做条件请求.

13、这些条件请求的头域在请求消息里是可选用的. 条件请求的头域可以解决并发请求的冲突问题。If-MatchIf-Match 请求头域被 HTTP 方法(PUT/DELETE)用来做有条件操作. 对一个或多个从群组服务器获得的实体，XDS 客户端可以在请求的If-MatchIf-Match头中包含某个实体的entity tag 以确认它所具有的那个实体是最新的.If-Match 头可以被用在以下场景中:条件 PUTXDM 客户端想增加或修改服务器 XDM 文档中的某个元素（element），并且希望服务器所具有的文档版本和客户端当前所具有的那个文档相同时才能修改。客户端可以在请求中包含

14、If-Match 头, 并将客户端所具有的实体标签（entity tag）值写在里面. 如果文档已经改变，群组服务器会拒绝这个请求返回 412 （条件失败）. 在这种情况下，客户端需要重新用 GET 请求从服务器获取这个文档并保存服务器在 200 OK 中返回的新的实体标签（entity tag）。 客户端可以把新的实体标签（entity tag）放在 If-Matc 头中重新请求修改文档。 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 7页如果操作成功， 响应消息的 etag 头会包含刚被修改过的资源的新的实体标签（entity tag）。 条件 DELETE X

15、DM 客户端也可以在 DELETE 请求中包含 If-Match 头来做条件删除. DELETE 请求的 200 OK 响应会包含一个 etag 头域, 带有所删除元素所在的整个文档的实体标签（entity tag）If-None-MatchIf-None-Match 请求头域可以和 GET 请求方法一起使用做条件请求. If-None-Match 头中可以包含客户端以前从服务器所获取的资源实体的实体标签（entity tag）。If-None-Match 头可以被用在以下场景中:条件 GET 当 XDM 客户端本地存有一个文档的版本，它可以做条件 GET 来判断服务器对统一文档

16、是否有更新。如果本地文档仍然是最新的，客户端就不会重新下载文档，以此节省网络的使用。为了达到这个目的，客户端在 GET 请求中携带 If-None-Match 头域，其中包含客户端当前文档的实体标签（entity tag）. 终端数据配置服务器如果发现服务器文档标签和客户端不同，会响应 200 OK. 如果服务器文档标签和客户端相同, 服务器会响应 304 Not Modified.3.43.4终端数据配置服务器终端数据配置服务器 XCAPXCAP 请求请求 URLURL1. XCAP 根节点 （XCAP root）XCAP 根定义了所有可被请求的资源所在的位置. XCAP 根用 HTTP U

17、RI 表示, 被称为 XCAP根 RUI。对终端数据配置服务器 XCAP 根 被定义为/TDCS FQDN/tdcs-services/.注：在具体构造 HTTP 请求时，TDCS FQDN 应该为 TDCS 服务器的地址，并且在发出 HTTP请求时放在 HOST HTTP 头中，而不是 Request-URI 中。另外，由于 TDCS 有主副地址，TDCS FQDN 可能是两个。（关于主副地址，请参见第 6 章）2. 文档选择器 （Document Selector）中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 8页在文档根节点下的每一个 XML 文档使用文档选择

18、器作为唯一标识，文档选择器类似于由多个路径标识符组成的一个完整路径，使用“/”作为路径分隔符. 第一个路径部分必须是XCAP AUID。终端数据配置服务器支持以下 XCAP AUID:USER-CONFIG:USER-CONFIG: 用来进行群组的操作用来进行群组的操作在每个 AUID 下有两个子 XCAP 分支. 一个称为 “用户树”（“user”tree）, 保存某个用户的终端配置文档“index”。 另一个分支是“全局树”（“global”tree）, 保存适用于所有用户的终端配置文档“index”. AUID 之后的路径部分必须是global 或 users. 每个用户对服务器而言都有

19、一个用户名，被称为 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/

20、XUI of user/index访问 TDCS 文档的 XML 元素，使用以下的 URL 格式:document selector/node selector3.53.5终端数据配置服务器器后向兼容对客户端终端数据配置服务器器后向兼容对客户端 XMLXML 解析的要求解析的要求这里的终端数据配置服务器客户端指所有与 TDCS 进行 HTTP/XCAP 通信客户端应用程序。TDCS 会不断加入新的功能. 群组管理的 XML schema 在将来可能会被扩展。TDCS 升级到新的版本而客户端有可能仍然是旧的版本。为了使TDCS 后向兼容，TDCS 客户端的实现必须要遵循以下建议:oTDCS 客户

21、端必须忽略服务器返回的合法的 XML 文档中不能识别的 XML 元素 或属性，而不是报错退出对文档的处理. 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 9页4 4终端数据配置服务器终端数据配置服务器 XCAPXCAP 接口规范接口规范4.14.1概述概述TDCS 为客户端应用提供 XCAP 接口来管理服务器存储的终端配置 XML 文档. 客户端应用可以 新建/读取 XML 文档及其 XML 元素和属性. 本章给出终端数据配置服务器 XCAP 接口规范。4.24.2正常响应正常响应如果客户端的请求被成功处理，TDCS支持成功的 2xx 状态码：状态码状态码描述描述2

22、00OK201Created4.2.1正常响应描述正常响应描述200 (OK) 响应当 XCAP GET/PUT/DELETE 请求被成功处理时返回.示例消息:HTTP/1.1 200 OKetag: bcbcbcContent-Length: 0. . .201 (Created) 响应当 XCAP PUT 请求被执行并其请求的 resrouce 已经产生.示例消息:HTTP/1.1 201 Createdetag: ababab. . .Content-Length: 0中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 10页4.34.3

23、错误错误响应响应XCAP 使用与HTTP协议相同定义的错误响应状态码。TDCS支持3类错误状态码：3xx, 4xx, 和 5xx. 3xx 是重定向状态码，指示客户端为满足请求去采取其它的行动。4xx 是客户端错误码，指出客户端请求可能包含的错误. 5xx 是服务器错误码，指示服务器知道自己遇到问题而不能处理当前的请求。状态码状态码描述描述304Not Modified400Bad Request403Forbidden404Not Found405Method Not Allowed409Conflict412Precondition Failed415Unsupported Media T

24、ype500Internal Server Error503Service Unavailable Error.1错误响应描述错误响应描述304 (Not Modified) 响应在条件 GET 中使用. 客户端在 If-None-Match 头中包含的 etag 与服务器所具有的该文档etag 相同响应消息示例:HTTP/1.1 304 Not ModifiedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0403 (Forbidden) 响应可以对 XCAP GET/PUT

25、/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-1Content-Length: 0400 (Bad Request) 响应可以对 XCAP GET/PUT/DELETE 操作响应。由于语法错误 T

26、DCS 不能理解该请求.中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 11页响应消息示例:HTTP/1.1 400 Bad RequestContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0404 (Not Found) 响应可以对 XCAP GET/PUT/DELETE 操作响应. TDCS 不能找到被请求的资源。响应消息示例:HTTP/1.1 404 Not FoundContent-Type: text/plain; charset=ISO-8859-1Content-Leng

27、th: 0405 (Method Not Allowed) 响应可以对 XCAP 请求响应. TDCS 理解请求的方法但是不支持该操作响应消息示例:HTTP/1.1 405 Method Not AllowedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0409 (Conflict) 响应可以对 XCAP GET/PUT/DELETE 操作响应。请求因对当前资源的冲突而不能完成。409 响应可携带 XML 消息体来指定冲突的具体原因。以下是 409 响应中所包含的“xcap-error” d

28、ata schema. “xcap-error” 可以用来给出具体冲突原因。客户端应该支持以下 schema： 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 12页 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 13页 响应消息示例:HTTP/1.1 409 ConflictContent-Type: application/xcap-error+xmlContent-Length: xxxxx中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 14页412 (Precondition Failed)

29、响应可以对 XCAP GET/PUT/DELETE 操作响应。 客户端可以携带 If-Match 头域来包含客户端所具有的 etag. 如果文档在服务器中已改变，412 就会被返回.响应消息示例:HTTP/1.1 412 Precondition FailedContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0415 (Unsupported Media Type) 响应可以对 XCAP GET/PUT/DELETE 操作响应。 终端数据配置服务器不接受请求消息中的内容编码。响应消息示例:HTTP/1.1 41

30、5 Unsupported Media TypeContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0500 (Internal Server Error) 响应可以对 XCAP GET/PUT/DELETE 操作响应. 终端数据配置服务器遇到不可预料的情况不能完成请求.响应消息示例:HTTP/1.1 500 Internal Server ErrorContent-Type: text/plain; charset=ISO-8859-1Content-Length: 00503 (Service

31、Unavailable) 响应可以对 XCAP GET/PUT/DELETE 操作响应. 终端数据配置服务器因过载或维护等原因暂时不能处理请求.响应消息示例:HTTP/1.1 503 Service UnavailableContent-Type: text/plain; charset=ISO-8859-1Content-Length: 0中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 15页4.44.4操作终端数据配置文档操作终端数据配置文档.1DataData SchemaSchemaTDCS 支持以下终端数据配置文档 schema。 中国电信

32、qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 16页 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 17页 中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 18页.2使用场景使用场景场景总结创建/替换用户终端数据配置文档查询用户终端数据配置文档增加 Call Restriction删除 Call Restriction查询和更新用户其它配置参数创建创建/ /替换用户终端数据配置文档替换用户终端数据配置文档.1. 概述该操作用来创建/替换适用于某用户的终端数据配置文档

33、.只有系统管理员可以创建/替换用户的终端配置文档。成功的 XCAP PUT 操作会返回 201 Created 响应（创建文档）或 200 OK 响应 （替换文档）. 失败的操作会返回 403 (Forbidden), 404 (Not Found) , 409 (Conflict) 或 412 (Precondition Failed)。.2. 用例AdminTDCS1. XCAP PUT2.a 201 Created2.b 403/404/409/412图 4-1 管理员创建用户终端书记配置文档1. 管理员创建一个用户终端数据配置文档。它发起一个 XCAP PUT 请求中国电

34、信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 19页请求消息:PUT http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index HTTP/1.1. . .ClientID: requestors XUIContent-Type: application/user-config+xmlContent-Length: xxxxxdocument content请求消息示例: 创建不含 Call Restrictions 的配置文件PUT http:/ HTTP/1.1. . .Clie

35、ntID: systemadmPTTContent-Type: application/user-config+xmlContent-Length: xxxxxTT 0280 true false 请求消息示例: 创建含 Call Restrictions 的配置文件PUT http:/ HTTP/1.1. . .ClientID: systemadmPTTContent-Type: application/user-config+xmlContent-Length: xxxxxTT 中国电信 qchat 业务终端参数配置接口技术要求-系统和

36、用户数据分册第 20页TT 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 numberContent-Length: 0响应消息示例:HTTP/1.1 201 Created. . .etag: abababContent-Length: 0查询用户终端数据配置文档查询用户终端数据配置文档.1. 概述

37、该操作用来从“用户树”下获取用户终端数据配置文档. XCAP GET 请求的响应消息包含详细的文档信息.某用户可以获取自己的用户终端配置文档。系统管理员可以获取所有用户的终端配置文档。中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 21页终端也要利用该操作获取创建或更新的配置信息。成功的 XCAP GET 操作会返回 200 OK 响应，并包含群组信息. 失败的操作会返回 304 (Not Modified ), 403 (Forbidden) 或 404 (Not Found)等。.2. 用例AdminTDCS1. XCAP GET2.a 200 OK

38、2.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 numberClientID: requestors XUIContent-Length: 0请求消息示例:GET http:/ HTTP/1.1. . .If-None-Match: abababClientID: sys

39、temadmPTTContent-Length: 02.a TDCS 接受 XCAP GET 请求返回 200 OK 响应，并包含配置信息2.b TDCS 拒绝请求返回 304/403/404 错误响应，并包含详细的错误信息响应消息:HTTP/1.1 200 OK中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 22页etag: etag numberContent-Type: application/user-config+xmlContent-Length: xxxxx. . .document content响应消息示例:HTTP/1.1 200 OKetag:

40、bcbcbcContent-Type: application/vnd.oma.poc.groups+xmlContent-Length: xxxxxTTTT 0 1 1 1 1 0 0280 true false 增加增加 CallCall RestrictionRestriction.1. 概述该操作可以用来修改终端数据配置文档增加 Call Restriction。XCAP PUT 被使用。请求消息中携带新的 Call Restriction。中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据

41、分册第 23页只有系统管理员可以发起此操作。成功的 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. 用例AdminTDCS1. XCAP

42、 PUT2.a 2012.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 的替换。请求消息：PUT http:/FQDN

43、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 numberClientID: requestors XUIContent-Type: application/xcap-el+xmlContent-Length: xxxxxdocument content中国电信 qch

44、at 业务终端参数配置接口技术要求-系统和用户数据分册第 24页请求消息示例:PUT http:/ HTTP/1.1. . .If-Match: abcdeClientID: systemadmPTTContent-Type: application/xcap-el+xmlContent-Length: xxxxx * 1 1 0 2.a TDCS 接受请求返回 201 Created. 2.b TDCS 拒绝请求返回 403/404/409/412 错误响应，并包含详细的错误信息响应消息：HTTP/1.1 201 Created. . .etag: etag numberContent-Le

45、ngth: 0响应消息示例:HTTP/1.1 201 Created. . .etag: abababContent-Length: 0删除删除 CallCall RestrictionRestriction.1. 概述该操作可以用来修改终端数据配置文档删除 Call Restriction。XCAP DELETE 被使用。只有系统管理员可以发起此操作。成功的 XCAP DELETE 操作返回 200 OK 响应. 失败的操作会返回 403 (forbidden), 404 (not found)或者 412(Precondition Failed)。中国电信 qc

46、hat 业务终端参数配置接口技术要求-系统和用户数据分册第 25页.2. 用例AdminTDCS1. XCAP DELETE2.a 2002.b 403/404/409/412图 4-4 管理员删除某一用户的 call restriction 配置信息1.管理员想删除某一用户的 Call Restriction 配置信息，发起一个 XCAP DELETE 请求请求消息：DELETE http:/FQDN of TDCS server/service name/user-config/users/XUI of user/index/user-config/carrier-level

47、-call-restrictions/call-restrictioncr-order=”CR Order Attribute Value” HTTP/1.1. . .If-Match: etag numberClientID: requestors XUIContent-Length: 0请求消息示例:PUT http:/ HTTP/1.1. . .If-Match: abcdeClientID: systemadmPTTContent-Length: xxxxx2.a TDCS 接受请求返回 200 OK. 2.b TDCS 拒绝请求返回 403/404/409 错误响应，并包含详细的错误

48、信息响应消息：HTTP/1.1 200 OK. . .etag: etag numberContent-Length: 0中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 26页响应消息示例:HTTP/1.1 200 OK. . .etag: abababContent-Length: 0查询和更新用户其它配置参数查询和更新用户其它配置参数.1. 概述该操作可以用来修改终端数据配置文档中 User Capability 所包含的参数。User Capability 包括 call-type-capability，add-mem-disable

49、-privilege，talk-group-permission 等参数。XCAP PUT 被使用。只有系统管理员可以发起此操作。成功的 XCAP PUT 操作返回 200 OK 响应. 失败的操作会返回 403 (forbidden), 404 (not found)，409 (conflict) and 412 (Precondition Failed)。.2. 用例AdminTDCS3. XCAP PUT4.a 2004.b 403/404/409/4121. XCAP GET 2. 200图 4-5 管理员更新某一用户的 user capability 参数 1， 2：管

50、理员想更新某一用户的 User Capability 中包含的某一参数，首先发起一个XCAP GET 请求获取整个文档中的已有参数详细消息参见“查询用户终端数据配置文档”3， 4：管理员更改该用户的 User Capability 参数，发起一个 XCAP PUT 请求放回更改过的文档中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 27页详细消息参见“创建/替换用户终端数据配置文档”中国电信 qchat 业务终端参数配置接口技术要求-系统和用户数据分册第 28页5 5终端数据配置服务器短消息（终端数据配置服务器短消息（SMSSMS）接口规范

51、）接口规范从 TDCS 的角度看，短消息是从 TDCS 服务器发送给 SMGW，而 SMSC 负责把短消息发送给手机。短信发送流程如下图：图 5-1短信发送流程步骤说明如下：1. TDCS 服务器与业务网关之间的连接采用 SMGP 协议，其 MServiceID=PTT；2. 业务网关收到 MServiceID 为“PTT”的短消息后，将 MServiceID=PTT 透传到 SMPP 协议的 serviceType 字段，然后将 SMPP 消息发送到短信中心；3. 短信中心根据 serviceType=PTT，将下发到手机的 teleserviceid 填为 65010。本章定义 TDCS 和短信中心发出的短消息负荷的格式。5.15.1TDCSTDCS 通知的短消息通知的短消息负荷负荷TDCS 短消息接口用来给用户终端发送有关配置信息更新的通知。当用户的终端数据配置文档被创建和修改时，TDCS 会发送配置信息更新通知给该用户。用户终端应该在收到该通知时主动到 TDCS 获取