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在微信朋友圈展示的效果图如下::