YD_T 3190-2016基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 移动互联网用户上下文感知业务.pdf

ICS 33.030M21YD中华人民共和国通信行业标准YD/T3190—2016基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）移动互联网用户上下文感知业务RESTfulbased ServiceCapabilityOpenAPIUserContentPerception of MobileInternet2016-10-22发布2017-01-01实施中华人民共和国工业和信息化部发布 YD/T 3190—2016目次前言，.II1范围2规范性引用文件3术语、定义和缩略语，3.1术语和定义缩略语。移动互联网用户上下文感知业务API定义.24.1业务概述4.2资源概述，4.3数据结构定义.44.4流程图.资源详细规范，.65.1 资源：用户上网信息5.2 资源：用户上网方式.75.3资源：是否通过蜂宽数据上网5.4资源：用户身份鉴权信息- 105.5资源：用户手机号码..125.6资源：用户伪码信息..136安全要求..156.1认证鉴权，..156.2用户隐私保护..15附录A（规范性附录）响应码要求参考文献..17 YD/T 3190—2016表7请求URL变量名称说明serverRoot服务器的URL基本构成：1hostname+portbase path，Port 和base path是可选的。例:/exampleAPIapiVersion要使用的API客户端版本uniqueValue为128bit的唯一随机数，作为应用服务器和移动互联网上下文感知平台确定的用户鉴权参数5.2.3响应代码和错误处理关于适用于移动互联网用户上下文感知业务API的异常策略和异常服务的错误代码，请查阅附录A，具体见表A.1。5.2.4 GET描述返回用户上网方式。请求GET /exampleAPI/userContentPerception/v1/userlnternetMode/uniqueValue HTTP/1.1Accept: application/xmlAuthorization: appKeyde33dc7dcc5bfbba14ebac548dab3b6fa6ale8f9,token=*60961e2870ed22f01bf39f327cadb8fr50559f08Host: 响应HTTP/1.1200 OKDate: Thu, 04Jun2009 02:51:59GMTContent-Type:application/xmlContent-Length: nnnn?xml version=1.0encoding-UTF-8? userContentPerception: UserlnternetMode xmlns: userContentPerception urn:ccsa:xml:rest:netapiuserContentPerception:1I--COMPLETED AMOUNT CHARGE TRANSACTION --userInternetMode ude/8uderatType1/ ratType/userInternetModes8 YD/T 3190—20165.2.5PUT资源不允许的方法。返回的HTTP错误状态是405。按照IETFRFC2616中14.7节，服务器在响应时还应包括“Allow：GET字段，5.2.6 POST资源不允许的方法，返回的HTTP错误状态是405。按照IETFRFC2616中14.7节，服务器在响应时还应包括“AlloW：GET’字段。5.2.7DELETE资源不允许的方法。返回的HTTP错误状态是405，按照IETFRFC2616中14.7节，服务器在响应时还应包括“AlloW：GET”字段，5.3资源：是否通过蜂窝数据上网5.3.1请求资源URL所使用的资源是：http://(serverRoot)/userContentPerception/ (apiVersion)/userlntermetMode/(uniqueValue)该资源用来进行是否通过蜂窝数据上网相关的操作，5.3.2请求URL变量对于所有的HTTP命令，下列请求URL变量是通用的，具体变量名称及说明见表8。表8请求URL变量名称说明serverRoot服务器的URL基本构成：hostname+port+basepathPort和base path是可选的，例：/exampleAPIapiVersion要使用的API客户端版本uniqueValue为128bit的唯一随机数，作为应用服务器和移动互联网上下文感知平台确定的用户鉴权参数5.3.3响应代码和错误处理关于适用于移动互联网用户上下文感知业务API的异常策略和异常服务的错误代码，请查阅附录A，具体见表AGET描述返回用