YD_T 2465-2013基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API） 微博业务.pdf

ICS 33.030M 21YD中华人民共和国通信行业标准YD/T2465-2013基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）微博业务RESTful based service capability open APlmicroblog2013-04-25发布2013-06-01实施中华人民共和国工业和信息化部发布 YD/T次前范围·2规范性引用文件…术语、定义和缩略语·3.1术语和定义3.2缩略语微博业务概述数据结构定义5.1 Type: Status5.2Type:5.3Type:User**5.4Type:Location5.5Type:Geo*5.6Type: DirectMessag5.7Type: Count*5.8Type: MicblogTopic*5.9Type: FriendGroup5.10Type:Relationship5.11Type: MicBlogError*5.12Enumeration: Gender-5.13Enumeration: ValueType-5.14Enumeration:HeatDegree接口定义6.1通用要求6.2微博数费访间接口6.3时间线接口6.4私信服务接口196.5话题服务相关接Iz6.6关系链接口6.7用户接口安全要求7.1认证和投权7.2API访间权限和频率控制30 YD/T应消息的包体内容类型，则响应消息与请求消息中包体内容类型尽量保持一致。女如果服务端不能支持所请求的内容类型，则返回HTTP406错误。6.1.2资源创建时的响应消息资源的创建可以通过HTTP“POST”操作或HTTP“PUT”探作来进行。如果资源创建成功：服务端则返回HTTP201Created消息，并在“Location”头中填写新创建的资源的位置；同时在响应消息包体中包含新创建资源的地址（填写在“resourceURL”参数中）或资源代表。在川“POST”操作进行资源创建时，比如发布--条微博、发表评论等，服务端判断所发布的内容是重复提交，则返回HTTP400错误。6.1.3异常处理当访间微博接口出现异常时，服务端返回HTTP错误码，有时也可同时返回MicBlogError数据类型的数据，携带微博业务接口的错误码信总。所使用的HTTP返回码和微博业务接口错误码见附录A，具体见表A.1和表A.2。6.2微博数据访问接口6.2.1发布单条微博资源URIhttp:/(serverRoot)/(apiVersion)/micBlog/ (userld)/statuses请求URI变量表15列出对此资源的所有HTTP探作都通用的变量。表15发布单条微博URI变量名称各注serverRoot服务基本url，由主机名+端口号+基本路径组成，; htp://:80/RESTAPIapiVersion接口版本号如对于v1.0版本，该字段为“1userld用户Id响应代码响应代码要求见附录A，具体见表A.1和表A.2。POST操作：发布单条微博通过该操作，用户可发布一条微博信息。.1请求请求参数见表16，其中，具体场景实例见附录B，表16发布单条微薄请求参数名称类型必选/可选捕述textxsd:string必选微博文学内容imagexsd: base64Binary可选图片，当发布带有图片的微博对，包体内客格式必颈是 application/multi-part 格式, IETF RFC1867longitudexsd:float可选经度latitodexsd:float可选纬度.2响应返回的资源数据是Status类型的数据或新创建的资源的url地址；！即单条微博信息。或返回新创建的资源URI。其中，具体场景实例见附承B， YD/T 246520136.2.2读取/副除单条微博资源URIhttp://(serverRoot)/(apiVersion)/micBlog/(userld)/statuses/(blogld)请求URI变量请求URI变量见表17。表17单条微博数据URI变量名称描述备注serverRoot服务基本url，由主机名+疆口号+基本路径组成，$t; htp:/:80/RESTAPIapiVersion接口版本号blogld微博ID响应代码响应代码要求见附录A，具体见表A.1和表A..4GET操作：读取单条微博.1请求无请求参数。.2响应返回的资源数据是Status类型的数据，即单条微博数据信息。DELETE操作：删除单条微博.1请求无请求参数。.2响应返回HTTP 204 No content.6.2.3转发微博资源URIhttp://(serverRoot)/(apiVersion)/micBlog/(userl