Statuses/destroy

跳转到: 导航, 搜索
 
(未显示1个用户的1个中间版本)
第1行: 第1行:
 
{{api_desc2|
 
{{api_desc2|
uri=direct_messages/destroy/:id|
+
uri=statuses/destroy/:id|
desc=根据ID删除登录用户收到的私信。|
+
desc=根据ID删除微博消息。注意:只能删除自己发布的微博消息。 |
 
format=XML/JSON|
 
format=XML/JSON|
 
httpMethod=POST/DELETE|
 
httpMethod=POST/DELETE|
 
needAuth=true|
 
needAuth=true|
 
rateLimit=true|
 
rateLimit=true|
params={{api_args|:id|true|int64|要删除的私信ID。}}|
+
params={{api_args|:id|true|int64|要删除的微博消息ID}}|
 
getParam=|
 
getParam=|
 
postParam=-X DELETE|
 
postParam=-X DELETE|
第13行: 第13行:
 
<pre>
 
<pre>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
<direct_message>
+
<status>
   <created_at>Mon Dec 06 11:35:37 +0800 2010</created_at>
+
   <created_at>Thu Dec 02 15:09:11 +0800 2010</created_at>
   <id>722778763</id>
+
   <id>4020772979</id>
   <text>qwe</text>
+
   <text>fTW9YwY</text>
   <sender_id>1854740027</sender_id>
+
   <source>
   <recipient_id>1854835127</recipient_id>
+
    <a href="">微博开放平台接口</a>
   <sender_screen_name>siegetest</sender_screen_name>
+
   </source>
   <recipient_screen_name>siegetest2</recipient_screen_name>
+
  <favorited>false</favorited>
   <sender>
+
   <truncated>false</truncated>
     <id>1854740027</id>
+
   <geo/>
     <screen_name>siegetest</screen_name>
+
  <in_reply_to_status_id/>
     <name>siegetest</name>
+
  <in_reply_to_user_id/>
 +
  <in_reply_to_screen_name/>
 +
   <user>
 +
     <id>1803876591</id>
 +
     <screen_name>loopa</screen_name>
 +
     <name>loopa</name>
 
     <province>11</province>
 
     <province>11</province>
 
     <city>8</city>
 
     <city>8</city>
 
     <location>北京 海淀区</location>
 
     <location>北京 海淀区</location>
     <description>ABCDE</description>
+
     <description>AnRHJLCc9Ac0fCY</description>
 
     <url/>
 
     <url/>
     <profile_image_url>http://tp4.sinaimg.cn/1854740027/50/1291272213/1</profile_image_url>
+
     <profile_image_url>http://tp4.sinaimg.cn/1803876591/50/0/1</profile_image_url>
 
     <domain/>
 
     <domain/>
 
     <gender>m</gender>
 
     <gender>m</gender>
     <followers_count>2</followers_count>
+
     <followers_count>28</followers_count>
     <friends_count>20</friends_count>
+
     <friends_count>2</friends_count>
     <statuses_count>18</statuses_count>
+
     <statuses_count>13714</statuses_count>
     <favourites_count>0</favourites_count>
+
     <favourites_count>1</favourites_count>
     <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
+
     <created_at>Wed Dec 01 00:00:00 +0800 2010</created_at>
 
     <following>false</following>
 
     <following>false</following>
 
     <verified>false</verified>
 
     <verified>false</verified>
 
     <allow_all_act_msg>false</allow_all_act_msg>
 
     <allow_all_act_msg>false</allow_all_act_msg>
 
     <geo_enabled>true</geo_enabled>
 
     <geo_enabled>true</geo_enabled>
   </sender>
+
   </user>
  <recipient>
+
</status>
    <id>1854835127</id>
+
    <screen_name>siegetest2</screen_name>
+
    <name>siegetest2</name>
+
    <province>11</province>
+
    <city>8</city>
+
    <location>北京 海淀区</location>
+
    <description/>
+
    <url/>
+
    <profile_image_url>http://tp4.sinaimg.cn/1854835127/50/0/1</profile_image_url>
+
    <domain/>
+
    <gender>m</gender>
+
    <followers_count>0</followers_count>
+
    <friends_count>20</friends_count>
+
    <statuses_count>2</statuses_count>
+
    <favourites_count>0</favourites_count>
+
    <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
+
    <following>false</following>
+
    <verified>false</verified>
+
    <allow_all_act_msg>false</allow_all_act_msg>
+
    <geo_enabled>true</geo_enabled>
+
  </recipient>
+
</direct_message>
+
 
</pre>
 
</pre>
 
===JSON示例===
 
===JSON示例===
 
<pre>
 
<pre>
 
{
 
{
     "sender_screen_name" : "zhangwei217245",
+
     "created_at" : "Thu Dec 02 14:22:35 +0800 2010",
     "recipient_screen_name" : "微博开放平台",
+
     "text" : "CT7rM6v",
     "text" : "Wow~~~Congratulations!",
+
     "truncated" : false,
     "recipient" :  
+
    "in_reply_to_status_id" : "",
 +
    "in_reply_to_screen_name" : "",
 +
    "geo" : null,
 +
     "user" :  
 
     {
 
     {
         "name" : "微博开放平台",
+
         "name" : "loopa",
         "domain" : "openapi",
+
         "domain" : "",
 
         "geo_enabled" : true,
 
         "geo_enabled" : true,
         "followers_count" : 13366,
+
         "followers_count" : 28,
         "statuses_count" : 158,
+
         "statuses_count" : 13715,
         "favourites_count" : 0,
+
         "favourites_count" : 1,
 
         "city" : "8",
 
         "city" : "8",
         "description" : "新浪微博开放平台市场推广官方账号,如有技术问题,请@微博API或者发私信给微博API",
+
         "description" : "4mcJW0EhJiU1GwN",
        "verified" : true,
+
        "status" :
+
        {
+
            "created_at" : "Mon Nov 29 16:08:43 +0800 2010",
+
            "text" : "各位开发者,我们的论坛上线啦~http://sinaurl.cn/h4FWc7 欢迎大家的参与~另外,关于技术相关的问题,可以在论坛上提出,也可以@微博API 这个官方技术支持账号哦~感谢大家对开放平台的支持~[呵呵]",
+
            "truncated" : false,
+
            "in_reply_to_status_id" : "",
+
            "in_reply_to_screen_name" : "",
+
            "geo" : null,
+
            "favorited" : false,
+
            "in_reply_to_user_id" : "",
+
            "id" : 3958728723,
+
            "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
+
        },
+
        "id" : 11051,
+
        "gender" : "m",
+
        "friends_count" : 5,
+
        "screen_name" : "微博开放平台",
+
        "allow_all_act_msg" : true,
+
        "following" : false,
+
        "url" : "http://open.t.sina.com.cn/",
+
        "profile_image_url" : "http://tp4.sinaimg.cn/11051/50/1280283165/1",
+
        "created_at" : "Wed Jan 20 00:00:00 +0800 2010",
+
        "province" : "11",
+
        "location" : "北京 海淀区"
+
    },
+
    "sender" :
+
    {
+
        "name" : "zhangwei217245",
+
        "domain" : "zhangwei217245",
+
        "geo_enabled" : true,
+
        "followers_count" : 24,
+
        "statuses_count" : 118,
+
        "favourites_count" : 3,
+
        "city" : "5",
+
        "description" : "ABCDE",
+
 
         "verified" : false,
 
         "verified" : false,
        "status" :
+
         "id" : 1803876591,
        {
+
            "created_at" : "Sat Dec 04 23:35:20 +0800 2010",
+
            "text" : "动物丛书的由来。。。http://sinaurl.cn/hbVjvr",
+
            "truncated" : false,
+
            "in_reply_to_status_id" : "",
+
            "annotations" :
+
            [
+
 
+
            ],
+
            "in_reply_to_screen_name" : "",
+
            "geo" : null,
+
            "favorited" : false,
+
            "in_reply_to_user_id" : "",
+
            "id" : 4087921127,
+
            "source" : "<a href=\"http://t.sina.com.cn\" rel=\"nofollow\">新浪微博</a>"
+
        },
+
         "id" : 1658122963,
+
 
         "gender" : "m",
 
         "gender" : "m",
         "friends_count" : 44,
+
         "friends_count" : 2,
         "screen_name" : "zhangwei217245",
+
         "screen_name" : "loopa",
 
         "allow_all_act_msg" : false,
 
         "allow_all_act_msg" : false,
 
         "following" : false,
 
         "following" : false,
 
         "url" : "",
 
         "url" : "",
         "profile_image_url" : "http://tp4.sinaimg.cn/1658122963/50/1282754213",
+
         "profile_image_url" : "http://tp4.sinaimg.cn/1803876591/50/0/1",
         "created_at" : "Tue Nov 03 00:00:00 +0800 2009",
+
         "created_at" : "Wed Dec 01 00:00:00 +0800 2010",
 
         "province" : "11",
 
         "province" : "11",
         "location" : "北京 朝阳区"
+
         "location" : "北京 海淀区"
 
     },
 
     },
     "sender_id" : 1658122963,
+
     "favorited" : false,
     "recipient_id" : 11051,
+
     "in_reply_to_user_id" : "",
     "id" : 722715041,
+
     "id" : 4019894325,
     "created_at" : "Mon Dec 06 11:21:31 +0800 2010"
+
     "source" : "<a href=\"\" rel=\"nofollow\">微博开放平台接口</a>"
 
}
 
}
</pre>
+
</pre>|
{{param_DM}}
+
useAge=如果参数错误,将返回400错误|
{{param_user}}|
+
useAge=
+
* 如果提供的私信ID不存在,则返回400错误,提示40010:Error: Direct Message does not exist!
+
* 如果提供的私信ID不属于当前登录用户,返回400错误,提示:40021:Error: not your own direct message!|
+
 
otherInfo=
 
otherInfo=
 
===Java示例===
 
===Java示例===
 
请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br>
 
请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br>
代码示例如下:
+
代码示意如下:
 
  package weibo4j.examples;
 
  package weibo4j.examples;
 
   
 
   
 
  import java.util.List;
 
  import java.util.List;
 +
import weibo4j.Status;
 +
import weibo4j.Weibo;
 
   
 
   
  import weibo4j.DirectMessage;
+
  public class DeleteStatus {
import weibo4j.Weibo;
+
import weibo4j.WeiboException;
+
 
   
 
   
/**
 
* @author hezhou
 
*
 
*/
 
public class DestroyDirectMessage {
 
 
  /**
 
  /**
  * 删除一条私信
+
  * 删除一条微博信息
 
  * @param args
 
  * @param args
 
  */
 
  */
 
  public static void main(String[] args) {
 
  public static void main(String[] args) {
 
  System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
 
  System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
    System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
+
    System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
try {
+
        try {
Weibo weibo = getWeibo(true,args);
+
        Weibo weibo = getWeibo(true,args);
weibo.destroyDirectMessage(Integer.parseInt(args[2]));
+
        //先发表一篇微博
List<DirectMessage> list = weibo.getDirectMessages();
+
        Status status = weibo.updateStatus("测试测试");
for(DirectMessage msg : list) {
+
        System.out.println(status.getId() + " : "+ status.getText()+"  "+status.getCreatedAt());
System.out.println(msg.toString());
+
        //删除刚发表的微博
}
+
        status = weibo.destroyStatus(status.getId());
  } catch (WeiboException e) {
+
        List<Status> list = weibo.getUserTimeline(args[2]);//args[2]:用户id
 +
        for(Status st : list) {//遍历当前微博信息
 +
        System.out.println(st.getId() + " : "+ st.getText()+"  "+st.getCreatedAt());
 +
        }
 +
  } catch (Exception e) {
 
  e.printStackTrace();
 
  e.printStackTrace();
 
  }
 
  }
 
  }
 
  }
+
  private static Weibo getWeibo(boolean isOauth,String[] args) {
+
  private static Weibo getWeibo(boolean isOauth,String ... args) {
 
  Weibo weibo = new Weibo();
 
  Weibo weibo = new Weibo();
 
  if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙
 
  if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙
weibo.setToken(args[0], args[1]);
+
  weibo.setToken(args[0], args[1]);
 
  }else {//用户登录方式
 
  }else {//用户登录方式
 
     weibo.setUserId(args[0]);//用户名/ID
 
     weibo.setUserId(args[0]);//用户名/ID
第211行: 第139行:
 
代码示例如下:
 
代码示例如下:
 
<pre>
 
<pre>
//Direct messages/destroy
+
//Statuses/destroy
//删除一条私信
+
 
$c = new WeiboClient( WB_AKEY ,  
 
$c = new WeiboClient( WB_AKEY ,  
 
                       WB_SKEY ,  
 
                       WB_SKEY ,  
 
                       $_SESSION['last_key']['oauth_token'] ,  
 
                       $_SESSION['last_key']['oauth_token'] ,  
 
                       $_SESSION['last_key']['oauth_token_secret']  );
 
                       $_SESSION['last_key']['oauth_token_secret']  );
//要删除的私信主键ID
+
//先发表一篇微博
$did = "Direct_Message_ID";
+
$msg = $c->update("测试发表微博");
$msg = $c->delete_dm( $did );
+
if ($msg === false || $msg === null){
 +
echo "Error occured";
 +
return false;
 +
}
 +
if (isset($msg['error_code']) && isset($msg['error'])){
 +
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
 +
return false;
 +
}
 +
echo($msg['id']." : ".$msg['text']." ".$msg["created_at"]);
 +
//删除刚发表的微博
 +
$c->destroy($msg['id']);
 +
if ($msg === false || $msg === null){
 +
echo "Error occured";
 +
return false;
 +
}
 +
if (isset($msg['error_code']) && isset($msg['error'])){
 +
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
 +
return false;
 +
}
 +
//user id
 +
$uid = "User ID";
 +
$msg = $c->user_timeline($uid);
 
if ($msg === false || $msg === null){
 
if ($msg === false || $msg === null){
 
echo "Error occured";
 
echo "Error occured";
第227行: 第175行:
 
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
 
echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
 
return false;
 
return false;
 +
}
 +
//遍历当前微博信息
 +
foreach($msg as $data){
 +
echo($data['id']." : ".$data['text']." ".$data["created_at"]);
 
}
 
}
echo('Deleted Message Info '.$msg['id'].' : '.$msg['text']);
 
 
</pre>
 
</pre>
 
}}
 
}}

2012年9月24日 (一) 11:37的最后版本

目录

statuses/destroy/:id

根据ID删除微博消息。注意:只能删除自己发布的微博消息。

URL

http://api.t.sina.com.cn/statuses/destroy/:id.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

POST/DELETE

是否需要登录

true
关于授权机制,参见授权机制声明

请求数限制

true
关于请求数限制,参见接口访问权限说明

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
:id true int64 要删除的微博消息ID

注意事项

如果参数错误,将返回400错误

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<status>
  <created_at>Thu Dec 02 15:09:11 +0800 2010</created_at>
  <id>4020772979</id>
  <text>fTW9YwY</text>
  <source>
    <a href="">微博开放平台接口</a>
  </source>
  <favorited>false</favorited>
  <truncated>false</truncated>
  <geo/>
  <in_reply_to_status_id/>
  <in_reply_to_user_id/>
  <in_reply_to_screen_name/>
  <user>
    <id>1803876591</id>
    <screen_name>loopa</screen_name>
    <name>loopa</name>
    <province>11</province>
    <city>8</city>
    <location>北京 海淀区</location>
    <description>AnRHJLCc9Ac0fCY</description>
    <url/>
    <profile_image_url>http://tp4.sinaimg.cn/1803876591/50/0/1</profile_image_url>
    <domain/>
    <gender>m</gender>
    <followers_count>28</followers_count>
    <friends_count>2</friends_count>
    <statuses_count>13714</statuses_count>
    <favourites_count>1</favourites_count>
    <created_at>Wed Dec 01 00:00:00 +0800 2010</created_at>
    <following>false</following>
    <verified>false</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>true</geo_enabled>
  </user>
</status>

JSON示例

{
    "created_at" : "Thu Dec 02 14:22:35 +0800 2010",
    "text" : "CT7rM6v",
    "truncated" : false,
    "in_reply_to_status_id" : "",
    "in_reply_to_screen_name" : "",
    "geo" : null,
    "user" : 
    {
        "name" : "loopa",
        "domain" : "",
        "geo_enabled" : true,
        "followers_count" : 28,
        "statuses_count" : 13715,
        "favourites_count" : 1,
        "city" : "8",
        "description" : "4mcJW0EhJiU1GwN",
        "verified" : false,
        "id" : 1803876591,
        "gender" : "m",
        "friends_count" : 2,
        "screen_name" : "loopa",
        "allow_all_act_msg" : false,
        "following" : false,
        "url" : "",
        "profile_image_url" : "http://tp4.sinaimg.cn/1803876591/50/0/1",
        "created_at" : "Wed Dec 01 00:00:00 +0800 2010",
        "province" : "11",
        "location" : "北京 海淀区"
    },
    "favorited" : false,
    "in_reply_to_user_id" : "",
    "id" : 4019894325,
    "source" : "<a href=\"\" rel=\"nofollow\">微博开放平台接口</a>"
}

其他

Java示例

请从 微博SDK开发包下载 下载Java SDK
代码示意如下:

package weibo4j.examples;

import java.util.List;
import weibo4j.Status;
import weibo4j.Weibo;

public class DeleteStatus {

	/**
	 * 删除一条微博信息
	 * @param args
	 */
	public static void main(String[] args) {
		System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
    	System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
       try {
        	Weibo weibo = getWeibo(true,args);
       	//先发表一篇微博
       	Status status = weibo.updateStatus("测试测试");
       	System.out.println(status.getId() + " : "+ status.getText()+"  "+status.getCreatedAt());
       	//删除刚发表的微博
       	status = weibo.destroyStatus(status.getId());
       	List<Status> list = weibo.getUserTimeline(args[2]);//args[2]:用户id
       	for(Status st : list) {//遍历当前微博信息
       		System.out.println(st.getId() + " : "+ st.getText()+"  "+st.getCreatedAt());
       	}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	private static Weibo getWeibo(boolean isOauth,String ... args) {
		Weibo weibo = new Weibo();
		if(isOauth) {//oauth验证方式 args[0]:访问的token;args[1]:访问的密匙
 			weibo.setToken(args[0], args[1]);
		}else {//用户登录方式
   		weibo.setUserId(args[0]);//用户名/ID
   		weibo.setPassword(args[1]);//密码
		}
		return weibo;
	}
}

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:

//Statuses/destroy
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
//先发表一篇微博
$msg = $c->update("测试发表微博");
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
} 
echo($msg['id']." : ".$msg['text']." ".$msg["created_at"]);
//删除刚发表的微博
$c->destroy($msg['id']);
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
}
//user id
$uid = "User ID";
$msg = $c->user_timeline($uid);
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
} 
//遍历当前微博信息
foreach($msg as $data){
	echo($data['id']." : ".$data['text']." ".$data["created_at"]);
}
文档更新时间: 2012-09-24