photos.upload

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

POST /photos/upload

上传图片

路径

http://api.fanfou.com/photos/upload.[json|xml|rss]

调用方法

POST 

限制条件

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

参数:

photo

  • 作用: 照片文件内容

  • 格式: photo=photo_file_content

  • 字段说明: 必选, 参考: RFC 1867

status

  • 作用: 照片描述

  • 格式: status=status

  • 字段说明: 可选

source

  • 作用: 消息来源

  • 格式: source=source_str

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

location

  • 作用: 发布消息的地点

  • 格式: location=location_str

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

mode

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

  • 格式: mode=[default|lite]

  • 字段说明: 可选

mode

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

  • 格式: mode=[default|lite]

  • 字段说明: 可选

format

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

  • 格式: format=html

  • 字段说明: 可选

callback

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

  • 格式: callback=javascript函数名

  • 字段说明: 可选

返回结果

成功

  • HTTP Status Code

    200 OK HTTP/1.1

  • 返回值

    • json格式

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