statuses.update

lisztli edited this page Dec 19, 2011 · 7 revisions
Clone this wiki locally

POST /statuses/update

发送消息

路径

http://api.fanfou.com/statuses/update.[json|xml|rss]

调用方法

POST 

限制条件

用户登录, 发送消息频率限制

参数:

status

  • 作用: 消息内容

  • 格式: status=status_text

  • 字段说明: 必选,长度不大于140

in_reply_to_status_id

  • 作用: 回复的消息id

  • 格式: in_reply_to_status_id=msg_id

  • 字段说明: 可选

in_reply_to_user_id

  • 作用: 回复的用户id

  • 格式: in_reply_to_user_id=user_id

  • 字段说明: 可选

repost_status_id

  • 作用: 转发的消息id

  • 格式: repost_status_id=msg_id

  • 字段说明: 可选

source

  • 作用: 消息来源

  • 格式: source=source_str

  • 字段说明: 可选, source应为英文字符串

mode

  • 作用: 当mode=default(默认)时,返回消息中用户信息包含用户自定义profile.mode=lite, profile不会包含在返回信息中

  • 格式: mode=[default|lite]

  • 字段说明: 可选

format

  • 作用: 当format=html时,返回消息中@提到的用户,网址等输出html链接

  • 格式: format=html

  • 字段说明: 可选

location

  • 作用: 发布消息的地点

  • 格式: location=location_str

  • 字段说明: 可选, 最多30个字符, 使用'地点名称' 或 '一个半角逗号分隔的经纬度坐标'。如:北京市海淀区 或者 39.9594049,116.298419

callback

  • 作用: 当使用json格式时,生成的json对象将作为参数传给指定的javascript函数

  • 格式: callback=javascript函数名

  • 字段说明: 可选

返回结果

成功

  • HTTP Status Code

    200 OK HTTP/1.1

  • 返回值

    • json格式

      返回发送完成的消息,详细格式参见statuses.show

失败

  • HTTP Status Code

    400 Bad Request HTTP/1.1