Skip to content

statuses.update

lisztli edited this page Dec 19, 2011 · 7 revisions

#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

Clone this wiki locally