Direct messages/destroy

跳转到: 导航, 搜索
(使用说明)
第19行: 第19行:
 
===请求参数===
 
===请求参数===
 
* id. 必填参数,要删除的私信主键ID.   
 
* id. 必填参数,要删除的私信主键ID.   
o Example: http://api.t.sina.com.cn/direct_messages/destroy/12345.json
+
o 示例: http://api.t.sina.com.cn/direct_messages/destroy/12345.json
  
 
===使用说明===
 
===使用说明===
 
* 参数错误,或者id不存在返回500错误
 
* 参数错误,或者id不存在返回500错误
  
===Response ===
+
===返回结果===
 
XML示例:
 
XML示例:
 
   <?xml version="1.0" encoding="UTF-8"?>
 
   <?xml version="1.0" encoding="UTF-8"?>
第83行: 第83行:
 
   </direct_message>
 
   </direct_message>
  
JSON:示例
+
JSON示例:
  
 
   {
 
   {
第138行: 第138行:
  
 
===使用示例===
 
===使用示例===
cURL:
 
  
 
* xml
 
* xml

2010年1月11日 (一) 11:38的版本

目录

删除私信

按ID删除私信。操作用户必须为私信的接收人。

URL

http://api.t.sina.com.cn/direct_messages/destroy/id.format

格式

xml, json

HTTP请求方式

POST, DELETE

是否需要身份验证

true

请求数限制

false

请求参数

  • id. 必填参数,要删除的私信主键ID.

o 示例: http://api.t.sina.com.cn/direct_messages/destroy/12345.json

使用说明

  • 参数错误,或者id不存在返回500错误

返回结果

XML示例:

 <?xml version="1.0" encoding="UTF-8"?>
 <direct_message>
   <created_at>Fri Jan 08 15:15:31 +0800 2010</created_at>
   <id>207675</id>
   <text>send dm 777</text>
   <sender_id>10506</sender_id>
   <recipient_id>11075</recipient_id>
   <sender_screen_name>name_10506</sender_screen_name>
   <recipient_screen_name>name_11075</recipient_screen_name>
   <sender>
     <id>10506</id>
     <screen_name>name_10506</screen_name>
     <name>name_10506</name>
     <province>0</province>
     <city>0</city>
     <location></location>
     <description></description>
     <profile_image_url>http://tp3.sinaimg.cn/10506/50/0</profile_image_url>
     <domain>10506</domain>
     <gender></gender>
     <email></email>
     <qq>5821</qq>
     <msn>msn_5821</msn>
     <followers_count>24</followers_count>
     <friends_count>50</friends_count>
     <statuses_count>47</statuses_count>
     <favourites_count>0</favourites_count>
     <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
     <following>false</following>
     <verified>false</verified>
     <geo_enabled>false</geo_enabled>
   </sender>
   <recipient>
     <id>11075</id>
     <screen_name>name_11075</screen_name>
     <name>name_11075</name>
     <province>0</province>
     <city>0</city>
     <location></location>
     <description></description>
     <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url>
     <domain>11075</domain>
     <gender></gender>
     <email></email>
     <qq>4102</qq>
     <msn>msn_4102</msn>
     <followers_count>28</followers_count>
     <friends_count>50</friends_count>
     <statuses_count>29</statuses_count>
     <favourites_count>0</favourites_count>
     <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
     <following>false</following>
     <verified>true</verified>
     <geo_enabled>false</geo_enabled>
   </recipient>
 </direct_message>

JSON示例:

 {
   "created_at":"Wed Jan 06 11:48:24 +0800 2010",
   "id":207568,
   "text":"test",
   "sender_id":10506,
   "recipient_id":11075,
   "sender_screen_name":"name_10506",
   "recipient_screen_name":"name_11075",
   "sender":
          {"id":10506,
           "screen_name":"name_10506",
           "name":"name_10506",
           "province":null,
           "city":null,
           "location":"",
           "description":"",
           "profile_image_url":"http://tp3.sinaimg.cn/10506/50/0",
           "domain":"10506",
           "email":"",
           "qq":"5821",
           "msn":"msn_5821",
           "followers_count":24,
           "friends_count":50,
           "statuses_count":0,
           "favourites_count":25,
           "created_at":"Thu Jan 01 08:00:00 +0800 1970",
           "following":false,
           "geo_enabled":false,
           "verified":false},
   "recipient":
          {"id":11075,
           "screen_name":"name_11075",
           "name":"name_11075",
           "province":null,
           "city":null,
           "location":"",
           "description":"",
           "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0",
           "domain":"11075",
           "email":"",
           "qq":"4102",
           "msn":"msn_4102",
           "followers_count":28,
           "friends_count":50,
           "statuses_count":0,
           "favourites_count":11,
           "created_at":"Thu Jan 01 08:00:00 +0800 1970",
           "following":false,
           "geo_enabled":false,
           "verified":true}
  }

使用示例

  • xml

curl -u user:password --http-request DELETE http://api.t.sina.com.cn/direct_messages/destroy/88619848.xml

  • json

curl -u user:password --http-request DELETE http://api.t.sina.com.cn/direct_messages/destroy/88619848.json