Direct messages/new
(→Response) |
(→使用示例) |
||
第143行: | 第143行: | ||
cURL: | cURL: | ||
+ | * xml: | ||
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 | 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 | ||
+ | |||
+ | * json: | ||
+ | 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.json |
2010年1月8日 (五) 14:49的版本
目录 |
发送私信
发送一条私信。必须包含参数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:
- xml:
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
- json:
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.json