上传图文消息素材
(以“上传图文消息素材”为内容创建页面) |
|||
第1行: | 第1行: | ||
− | 上传图文消息素材 | + | =上传图文消息素材= |
+ | |||
+ | 当用户主动发消息给认证账号的时候(包括发送信息、关注事件、扫描二维码事件),微博将会把消息数据推送给开发者,开发者在一段时间内(目前为7天)可以调用客服消息接口一定次数(目前用户发送消息,则认证账号可以回复3次,用户关注公众账号,公众账号可以回复1次),通过POST一个JSON数据包来发送消息给普通用户。 | ||
+ | |||
+ | |||
+ | ==URL== | ||
+ | https://m.api.weibo.com/2/messages/reply.json | ||
+ | |||
+ | ==HTTP请求方式== | ||
+ | POST | ||
+ | |||
+ | ==是否需要登录== | ||
+ | 是<br/> | ||
+ | 关于登录授权,参见 [[授权机制说明|如何登录授权]] | ||
+ | |||
+ | ==POST数据说明== | ||
+ | POST数据示例如下: | ||
+ | <pre> | ||
+ | { | ||
+ | "articles": [ | ||
+ | { | ||
+ | "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p", | ||
+ | "author":"xxx", | ||
+ | "title":"Happy Day", | ||
+ | "content_source_url":"www.qq.com", | ||
+ | "content":"content", | ||
+ | "digest":"digest" | ||
+ | }, | ||
+ | { | ||
+ | "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p", | ||
+ | "author":"xxx", | ||
+ | "title":"Happy Day", | ||
+ | "content_source_url":"www.qq.com", | ||
+ | "content":"content", | ||
+ | "digest":"digest" | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" | ||
+ | |- | ||
+ | !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"| | ||
+ | !width="5%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|必选 | ||
+ | !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|类型及范围 | ||
+ | !width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | ||
+ | {{api_args|source|false|string|采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。}} | ||
+ | {{api_args|access_token|false|string|采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。}} | ||
+ | {{api_args|type|true|string|需要以何种类型的消息进行响应,text:纯文本、articles:图文、position:位置。}} | ||
+ | {{api_args|data|true|string|消息数据,具体内容严格遵循type类型对应格式,必须为json做URLEncode后的字符串格式,采用UTF-8编码。}} | ||
+ | {{api_args|receiver_id|false|int64|消息接收方的ID。}} | ||
+ | {{api_args|id|false|int64|需要响应的消息ID,该字段仅仅针对使用message/receive长连接服务接收到的消息;如果使用消息推送服务,则必须使用receiver_id参数而不是id参数}} | ||
+ | |} |
2014年5月7日 (三) 14:38的版本
目录 |
上传图文消息素材
当用户主动发消息给认证账号的时候(包括发送信息、关注事件、扫描二维码事件),微博将会把消息数据推送给开发者,开发者在一段时间内(目前为7天)可以调用客服消息接口一定次数(目前用户发送消息,则认证账号可以回复3次,用户关注公众账号,公众账号可以回复1次),通过POST一个JSON数据包来发送消息给普通用户。
URL
https://m.api.weibo.com/2/messages/reply.json
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
POST数据说明
POST数据示例如下:
{ "articles": [ { "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p", "author":"xxx", "title":"Happy Day", "content_source_url":"www.qq.com", "content":"content", "digest":"digest" }, { "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p", "author":"xxx", "title":"Happy Day", "content_source_url":"www.qq.com", "content":"content", "digest":"digest" } ] }
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
type | true | string | 需要以何种类型的消息进行响应,text:纯文本、articles:图文、position:位置。 |
data | true | string | 消息数据,具体内容严格遵循type类型对应格式,必须为json做URLEncode后的字符串格式,采用UTF-8编码。 |
receiver_id | false | int64 | 消息接收方的ID。 |
id | false | int64 | 需要响应的消息ID,该字段仅仅针对使用message/receive长连接服务接收到的消息;如果使用消息推送服务,则必须使用receiver_id参数而不是id参数 |