YD_T 2976-2015基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 点击拨号业务.pdf

ICS 33.030M 21YD中华人民共和国通信行业标准YD/T2976-2015基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）点击拨号业务RESTful based service capability open API - Click to dial2015-10-14发布2016-01-01实施中华人民共和国工业和信息化部发布 YD/T次前言1范围2规范性引用文件*3术语、定义和缩略语+*+3.1术语和定义.3.2缩略语4点击拨号业务特征概述5按口定义说明·6数据结构定义6.1CallNumInfo*6.2Call-.6.3Calllnfo6.4CallStatusNotification..7接口定义·7.1发起点击拨号呼叫7.2终止点击拨号呼叫7.3查询点击拨号状态呼叫7.4开启点击授号呼叫通知7.5关闭点击投号通知..7.6点击拨号呼叫状态通知..8授权框架..8.1使用Autho4API框架.8.2‘acr:auth的用法*+ 5附录A（规范性附录）响应码要求.附录B（资料性附录）消息样例…参考文献 YD/T17URI变量说明变量撼达serverRoot服务器基本URLapiVersionAPI版本id通知序号，如果只有1个通知请求时，则不带7.5.33响应码对响应码要求见附录A：7.5.4DELETE操作请求关闭点击拨号通知请求消息，具体见表18.表18关闭点击拨号通知请求消息HITP方送URL描述DELETEhttp://(serverRoot)/(apiVersion)/关闭点击授号通知。在开启点击找号通如接口的返回中，Locationctd/rest/CallStatusNotification/(id)头域会包含该URL报头必选/可选描述AuthorizationBasic (credential)其中(credential)为Base64编码的格式为“用户名；密码的字符串X-DEV-ID必选运营商分配的合作伙件标识，合作伙伴可以为CP/SP或个人开发者X-Service-ID必选运营商分配的应用标识X-FA-ID可选计费标识Host必选业务平台域名响应关闭点击拨号通知响应消息，具体见表19。表19关闭点击缓号通知响应消息HTTP电应码响应短语推述200OK关闭短信通知成功7.6点击拨号呼叫状态通知7.6.1点击拨号呼叫状态通知资源URLhttp://(serverRoot)/(apiVersion)/ctd/rest/StatusNotification/7.6.2请求URI变量请求URI变量，具体见表20.表20URI变量说明变款serverRoot服务器基本URLapiVersionAPI版本7.6.3响应码对响应码要求见附录A。8 YD/T 297620157.6.4POST操作请求点击拨号呼叫状态通知请求消息，具体见表21。表21点击拨号呼叫状态通知请求消息HTTP方法URL描述POSThttp:/(serverReot)/(apiVersion)应用端用于接收StatusNotification的RESTURL.其中Host，port分/ectd/rest/StatusNotification/别是应用方的地址和端口报头必选/选值描述Authorization可选Basic (credential)其中(credential)为 Base64 编码的格式为“用户名；密码”Content-Type必选application/json 或 application/xml目前只支持application/json格式或application/xml格式消息体必选/可选数据类型数据格式描述Callnfol可选Callnfe 类型的数JSON/XML组。参见.2响应点击拨号呼叫状态通知响应消息，具体见表22。表22点击拨号呼叫状态通知响应消息HTP电度码咖应版语200OK操作成功且呼叫末结束，状态可查询8授权框架8.1使用Autho4API框架点击拨号API可以支持OMA-ER-Autho4API-V1_0中定义的授权框架，OAuth是一种开放的协议，为桌面程序或者Web应用提供了一种简单的，标准的方式去访间需要用户授权的API服务。当文件传输API支持OMA-ER-Autho4API-V1_0时，应遵[REST_NetAPI_Common]中的D.1,8.22acr:auth的用法本小节规定了在资源URL路径中使用acrauth作为最终用户标识的用法。“acr.auth表示个acrURI，其中auth是一个保留关键字，可以被用来避免在资源URL路径暴露一个真正的最终用户标识符。当文件传输API和OMA-ER-Autho4API-