分享到 :

add_one_blog

[no_toc]

特别声明：
add_one_blog接口已于2014.3.31正式下线。请PC网站调用PC空间分享组件，移动端下载最新版本的SDK后调用shareToQQ或shareToQzone接口，以满足用户分享一条动态（feeds）到QQ空间的功能。

 

1 接口说明

登录用户发表一篇新日志。

1.1 URL

OAuth2.0协议： https://graph.qq.com/blog/add_one_blog

1.2 格式

JSON，XML

1.3 HTTP请求方式

POST

1.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）通用参数
-OAuth2.0协议必须传入的通用参数，详见这里。
（2）私有参数

参数名称 是否必须 类型 描述
title 必须 string 日志标题（纯文本，最大长度128个字节，utf-8编码）。
content 必须 string 文章内容（html数据，最大长度100*1024个字节，utf-8编码）.
format   string 定义API返回的数据格式。 
取值说明：为xml时表示返回的格式是xml；为json时表示返回的格式是json。
注意：json、xml为小写，否则将不识别。format不传或非xml，则返回json格式数据。

1.5 请求示例

1. 请求参数以OAuth2.0协议为例（敏感信息都用*号进行了处理，实际请求中需要替换成真实的值）：

access_token==**********
oauth_consumer_key=123456
openid==**********
format=xml
title=test abc
content=test content

2. 对参数进行URL编码后拼接出的POST请求包：

POST /blog/add_one_blog HTTP/1.1
//…此处省去部分HTTP头部
Host: graph.qq.com
Content-Length: 294
Connection: Keep-Alive
Cache-Control: no-cache
access_token=**********& oauth_consumer_key=123456& openid=**********& format=xml& title=test%20abc& content=test%20content

 
3.下面是Post请求的HTML Form代码，开发者可以使用此表单来测试（供PC网页使用）：

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
  <HEAD>
     <TITLE> New Document </TITLE>
     <META NAME="Generator" CONTENT="EditPlus">
     <META NAME="Author" CONTENT="">
     <META NAME="Keywords" CONTENT="">
     <META NAME="Description" CONTENT="">
  </HEAD>
  <BODY>
     <form action="https://graph.qq.com/blog/add_one_blog" method="post">
        access token<input value="********..." name="access_token" /><br>
        appid<input value="222222" name="oauth_consumer_key" /><br>
        openid<input value="="********" " name="openid" /><br>
        title<input value="test" name="title" /><br>
        content<input value="真不错" name="content" /><br><br>
        <input type="submit" value="发表日志" />
     </form>
  </BODY>
</HTML>

 

1.6 返回参数说明

ret: 返回码
msg: 如果ret<0，会有相应的错误信息提示，返回数据全部用UTF-8编码
url: 固定为http://i.qq.com。用户在登录态下，可以通过该URL直接进入空间首页（这里不直接返回新发表日志的URL是为了避免泄漏用户信息）

1.7 返回码说明

0: 正确返回
其它: 失败。错误码说明详见：公共返回码说明。

1.8 正确返回示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<data>
   <ret>0</ret>
   <msg>"succ"</msg>
   <url>http://i.qq.com</url>
</data>

1.9 错误返回示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<data>
   <ret>2021</ret>
   <msg>"请先登录"</msg>
</data>

 

返回顶部