POST /timeline

URL: https://api.weixin.qq.com/timeline.format

参数列表

参数含义

content_type

指定消息的类型，必填，目前支持五类：text、photo、feed、video和music。

title

一句话描述，当content_type是feed时为必填字段。

对于content_type为feed，该字段可以是文章标题；

对于content_type为music，该字段可以是歌曲名和歌手；

对于content_type为video，该字段可以是视频的名称。

media_list

media_id列表，content_type为feed、music和video时必填。多个media_id以“,”分隔。

当content_type为photo，最多可以提供9个media_id，多出部分会被抛弃。

当content_type为feed、music和video时，只可提供1个media_id作为消息的缩略图，多出部分会被抛弃。

media_url

音乐文件地址，当content_type为music时必填。协议支持http和https，格式支持mp3和wav。

content_url

内容链接，当content_type为feed、music和video时必填

coordinates

经纬度，用“,”分隔，可选。数据格式为(latitude,longitude)

该API用于分享内容至用户的朋友圈中，title或media_list两个参数至少选择其中之一。

请求示例 1(使用curl工具)：

curl -d "title=hello&coordinates=10.00,10.00&media_list=fPPPmh9EBsgdrqaSJvl6nPvchUfbDxN8lmGTMBN2BWABP_usGso5Qx7raSraaXAT,fPPPmh9EBsgdrqaSJvl6nPvchUfbDxN8lmGTMBN2BWABP_usGso5Qx7raSraaXAT"

"https://api.weixin.qq.com/timeline?access_token=3Zkx2gyQVaeIbS1CTDFSZilrVyj1Q1Ts2UeArlEnbrP6bKDyWAz4WlIHu_LjJqUNdYDYlyxrGOw1ywdb4sAyahgskuUBvSSx6EO2oxowQmcwdC3YTDkSJPTF6yoKpfZkY2mIGBeaMZKsXcfWoTP94g"

成功返回：

{

"id" : 11232109051049549826,

"created_at" : 1333007682

}

失败返回：

{

"time" : 1338972300,

"error" : { "msg": "content_url is missing", "code": 40329 }

}

请求示例 2：

curl -d "title=Complcated&coordinates=24.00,114.00&media_list=L5JPCzX96wnwcE4Hthh&content_url=http%3A%2F%2Fy.qq.com%2Fi%2Fsong.html%23p%3D7B2273&media_url=http%3A%2F%2Fy.qq.com%2Fi%2Fsong.html%23p%3D7B2273&content_type=music"

"https://api.weixin.qq.com/timeline?access_token=3Zkx2gyQVaeIbS1CTDFSZilrVyj1Q1Ts2UeArlEnbrP6bKDyWAz4WlIHu_LjJqUNdYDYlyxrGOw1ywdb4sAyahgskuUBvSSx6EO2oxowQmcwdC3YTDkSJPTF6yoKpfZkY2mIGBeaMZKsXcfWoTP94g"

请求示例2在微信朋友圈展示的效果图如下：：