定义API返回的数据格式。
取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。
注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。
content
string
表示要发表的微博内容。必须为UTF-8编码,最长为140个汉字,也就是420字节。
如果微博内容中有URL,后台会自动将该URL转换为短URL,每个URL折算成11个字节。
若在此处@好友,需正确填写好友的微博账号,而非昵称。
clientip
string
用户ip。
必须正确填写用户侧真实ip,不能为内网ip及以127或255开头的ip
,以分析用户所在地。
longitude
string
用户所在地理位置的经度。
为实数,最多支持10位有效数字。有效范围:-180.0到+180.0,+表示东经,默认为0.0。
latitude
string
用户所在地理位置的纬度。
为实数,最多支持10位有效数字。有效范围:-90.0到+90.0,+表示北纬,默认为0.0。
syncflag
string
标识是否将发布的微博同步到QQ空间(0:同步; 1:不同步;),默认为0。
该参数只支持OAuth1.0,OAuth2.0暂不支持。
compatibleflag
string
容错标志,支持按位操作,默认为0。
0x20:微博内容长度超过140字则报错;
0:以上错误均做容错处理,即发表普通微博。
1.5 请求示例
以OAuth2.0协议为例,POST请求包示例:
POST /t/add_t HTTP/1.1
Host: graph.qq.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 352
Connection: Keep-Alive
Cache-Control: no-cache
access_token=*************&oauth_consumer_key=123456&openid=****************&format=json&content=hello
1.6 返回参数说明
-公共返回码说明详见:
公共返回码说明
。
-微博OpenAPI私有返回码详见:
微博私有返回码说明
。
-本接口私有返回码说明详见:
这里
。
errcode
二级错误码,详见:
微博私有返回码说明
。
如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码。
微博消息的ID,用来唯一标识一条微博消息。
微博消息的发表时间。
1.7 正确返回示例
ret:0,
msg:"ok",
errcode:0,
data:
id:12345678,
time:12863444444
1.8 错误返回示例
Content-type: text/html; charset=utf-8
ret:4,
msg:"禁止访问,城市,QQ号码被加入黑名单",
errcode:5