2010年1月8日 (五) 14:48的版本

发送私信

发送一条私信。必须包含参数user和text,请求必须使用POST方式提交。成功将返回完整的发送消息。

URL

http://api.t.sina.com.cn/direct_messages/new.format

格式

xml, json

HTTP请求方式

POST

是否需要身份验证

true

请求数限制

false

请求参数

• id: 必须参数. UID或账户名. 为了支持数字的账户名，需选填写下面2个参数screen_name或user_id:
• screen_name: 账户名
• user_id: 新浪UID
• text: 必须参数. 要发生的消息内容，需要做URLEncode，文本大小必须小于300个汉字.

使用说明

• 此接口问更新受限接口，越权将返回http 403 错误
• This method is subject to update limits. A HTTP 403 will be returned if this limit has been hit.

Response

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
 <direct_message>
   <created_at>Fri Jan 08 14:45:39 +0800 2010</created_at>
   <id>207662</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":"Fri Jan 08 14:46:37 +0800 2010",
   "id":207664,
   "text":"send dm 777",
   "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":"0",
        "city":"0",
        "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":47,
        "favourites_count":0,
        "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":"0",
        "city":"0",
        "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":29,
        "favourites_count":0,
        "created_at":"Thu Jan 01 08:00:00 +0800 1970",
        "following":false,
        "geo_enabled":false,
        "verified":true}
 }

使用示例

cURL:

curl -u user:password -d "text=all your bases are belong to us&user=user_2" http://api.t.sina.com.cn/direct_messages/new.xml