YD_T 2977-2015基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 短消息和多媒体消息业务.pdf

ICS 33.030M 21YD中华人民共和国通信行业标准YD/T2977-2015基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）短消息和多媒体消息业务RESTful basedServiceCapabilityOpenAPSMSandMMS2015-10-14发布2016-01-01实施中华人民共和国工业和信息化部发布 YD/T15（续）报头必选/可选猫述Autborizatioa必选Basie (credential)其中 (eredential)为Base64 编码的格式为“用户名；密码”的字符申X-DEV-ID必选送营商分配的合作伙伴标识，合作伙伴可以为CP/SP或个人开发者X-Service-ID必选运营商分配的应用标识X-FA-ID可选计费标识Host必选业务平台域名Content-Type必造application/json 或 application/xml对盘的 charset=UTF-8消品体必选/可选数据类型数据格式描述.2响应发送文本短消息成功响应消息，具体见表16。表16发送文本短消息成功响应消息TP电成码购短语202Accepted发送短消息成动报头必选/呵选描达Location可选https:/ (serverRoot)/(apiVersioe)(requestid)是业务平台产生/sms/restdeliveryStatus/(requestld）的对此次操作的唯一标识8.1.2查询短消息通知(GetReceivedSms)查询短消息通知（GetReceivedSms)资源URhttp://(serverRoot)/(apiVersion)/sms/rest/registration/(registrationld)/messages请求URI变量请求URI变量，具体见表17.表17URI变量说明serverRoot服务器基本URLapiVersionAPI版本registrationld短消息的上行接入码响应码对响应码要求见附录A。GET操作.1请求查询短消息通知请求消息，具体见表18表18查沟短消息通知请求消息HTTP方法URLGEThttp:/f(serverRoot)/(spiVersion)/sms/rest/registration/(registrationld)/messages7 YD/T18(续)报头必选/可选搭达Authorization必选Basic (credential)其中(credential)为Base64 编码的格式为“用户名；密码”的字特申X-DEV-ID必选运营商分配的合作伙伴标识，合作伙佛可以为CP/SP或个人开发者X-Service-ID必选运营商分配的应用标识报头必选/可选值描速X-FA-ID可选计费标识Host必速业务平台域名[Acept必选application/json 或 application/xml.2响应查询短消息通知成功响应消息，具体见表19。表19查询短消息通知成功响应消息描述200OK获取短消息上行通知成功授头必选/可鸡Content-Type必选application/json 或 application/xml消总体必选/可选数据类型数据格式招达receivedSMS必选ReoeivedSMSList( 6.2.7)JSON/XML短清息内客8.1.3查询发送状态报告（GetSmsDeliveryStatus)查询发送状态报告(GetSmsDeliveryStatus)资源URIhttp:/ [serverRoot)/(apiVersion)/sms/rest/deliveryStatus/ (requcestld)请求URI变量请求URI变量，具体见表20。表20URI变量说明变款serverRoot服务器基本URLapiVersionAPI版本reguestld业务平台产生的对发送短消息操作的唯一标识响应码对响应码要求见附录A。GET操作.1请求查询发送状态报告请求消息，具体见表21.表21查询发送状态报告请求消息HTIP办法URLGEThttp://(serverRoot)/ (apiVersion)/sms/rest/deliveryStatas/(recuestld) YD/T21(续）报头必选可选Authorization必选Basic (credential)其中(credential)为 Base64 编码的格式为“用户名：密码”的字符串X-DEV-ID必选运营商分配的合作伙伴标识，合作伙伴可以为CP/SP或个人开发者X-Servioe-ID必逸运营费分配的应用标识。X-FA-ID可选计费标识Host必选业务平台域名A