C/2/statuses/upload url text/biz

跳转到: 导航, 搜索

statuses/upload_url_text/biz

发布一条微博同时指定上传的图片或图片url。

URL

https://c.api.weibo.com/2/statuses/upload_url_text/biz.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制


请求所有商业接口:

    • 50000次/小时/IP;

请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
status false string 要发布的微博文本内容,必须做URLencode,内容不超过140个汉字。
visible false int 微博的可见性,0:所有人能看,1:仅自己可见,2:密友可见,3:指定分组可见,默认为0。
list_id false string 微博的保护投递指定分组ID,只有当visible参数为3时生效且必选。
url false string 图片的URL地址,必须以http开头。
pic_id false string 已经上传的图片pid,多个时使用英文半角逗号符分隔,最多不超过9个。
lat false float 纬度,有效范围:-90.0到+90.0,+表示北纬,默认为0.0。
long false float 经度,有效范围:-180.0到+180.0,+表示东经,默认为0.0。
annotations false string 元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息,每条微博可以包含一个或者多个元数据,必须以json字串的形式提交,字串长度不超过512个字符,具体内容可以自定。
rip false string 开发者上报的操作用户真实IP,形如:211.156.0.1。
is_longtext false int 是否发送超过140字微博,0:不超过140字,1:超过140字但在2000字以内,默认为0。操作用户需满足发送超过140字微博资格。

注意事项

  • picid或url必选一个,两个参数都存在时,取picid参数的值为准;
  • 连续两次发布的微博不可以重复;
  • 非会员发表定向微博,分组成员数最多200;

返回结果

JSON示例

//成功返回
{
    "created_at": "Wed Oct 24 23:49:17 +0800 2012",
    "id": 3504803600500000,
    "mid": "3504803600502730",
    "idstr": "3504803600502730",
    "text": "分组定向图片微博",
    "source": "新浪微博</a>",
    "favorited": false,
    "truncated": false,
    "in_reply_to_status_id": "",
    "in_reply_to_user_id": "",
    "in_reply_to_screen_name": "",
    "thumbnail_pic": "http://ww2.sinaimg.cn/thumbnail/71666d49jw1dy6q8t3p0rj.jpg",
    "bmiddle_pic": "http://ww2.sinaimg.cn/bmiddle/71666d49jw1dy6q8t3p0rj.jpg",
    "original_pic": "http://ww2.sinaimg.cn/large/71666d49jw1dy6q8t3p0rj.jpg",
    "geo": {
        "type": "Point",
        "coordinates": [
            40.413467,
            116.646439
        ]
    },
    "user": {
        "id": 1902538057,
        "idstr": "1902538057",
        "screen_name": "张三",
        "name": "张三",
        "province": "11",
        "city": "8",
        "location": "北京 海淀区",
        "description": "做最受尊敬的互联网产品经理...",
        "url": "",
        "profile_image_url": "http://tp2.sinaimg.cn/1902538057/50/22817372040/1",
        "profile_url": "304270168",
        "domain": "shenbinzhu",
        "weihao": "304270168",
        "gender": "m",
        "followers_count": 337,
        "friends_count": 534,
        "statuses_count": 516,
        "favourites_count": 60,
        "created_at": "Sat Dec 25 14:12:35 +0800 2010",
        "following": false,
        "allow_all_act_msg": true,
        "geo_enabled": true,
        "verified": false,
        "verified_type": 220,
        "allow_all_comment": true,
        "avatar_large": "http://tp2.sinaimg.cn/1902538057/180/22817372040/1",
        "verified_reason": "",
        "follow_me": false,
        "online_status": 0,
        "bi_followers_count": 185,
        "lang": "zh-cn",
        "level": 7,
        "type": 1,
        "ulevel": 0,
        "badge": {
            "kuainv": {
                "level": 0
            },
            "uc_domain": 0,
            "enterprise": 0,
            "anniversary": 0
        }
    },
    "reposts_count": 0,
    "comments_count": 0,
    "attitudes_count": 0,
    "mlevel": 0,
    "visible": {
        "type": 3,
        "list_id": 3469454702570000
    }
}
//失败返回
{
    "request": "/statuses/upload_url_text/biz.json",
    "error_code": XXXXX,
    "error": "error message."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


api评价