模板消息
(→接口请求参数) |
(→接口请求参数) |
||
第26行: | 第26行: | ||
{{api_args|receiver_id|true|long|消息接收方的ID。}} | {{api_args|receiver_id|true|long|消息接收方的ID。}} | ||
{{api_args|template_id|false|string|用户模板的ID,utid。}} | {{api_args|template_id|false|string|用户模板的ID,utid。}} | ||
− | {{api_args|data|true|string| | + | {{api_args|data|true|string|要发给用户的数据,json格式,还需补充该json格式的说明文档}} |
{{api_args|url|true|string|要发给用户的数据,json格式。}} | {{api_args|url|true|string|要发给用户的数据,json格式。}} | ||
{{api_args|data|true|string|要发给用户的数据,json格式。}} | {{api_args|data|true|string|要发给用户的数据,json格式。}} |
2014年11月9日 (日) 13:51的版本
模板消息
模板消息仅用于向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。
调用API接口发送模板消息之前,需要先在粉服管理后台申请模板ID;
说明:申请模板消息遇到问题可邮件 chujie@staff.sina.com.cn 。
URL
http://api.weibo.com/2/eps/template/send.json
HTTP请求方式
POST
接口请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。 |
receiver_id | true | long | 消息接收方的ID。 |
template_id | false | string | 用户模板的ID,utid。 |
data | true | string | 要发给用户的数据,json格式,还需补充该json格式的说明文档 |
url | true | string | 要发给用户的数据,json格式。 |
data | true | string | 要发给用户的数据,json格式。 |
注意事项
- 1、请求示例:http://api.weibo.com/2/eps/template/send.json?access_tocken=2.00DtpjEDBOC92Eecbf500fd5RdBZ8D&receiver_id=2662732725&template_id=9db1c3adf9a06fbd4bc94df2e2322a7484da0f7c7d1bfe24048b0babc707e301&data={"key1":"MockValue1","key2":"MockValue2","key3.":"MockValue3","key4":{"subkey0":"subMockValue0","subkey1":"subMockValue1"}}
- 2、调用接口前,需要先申请到模板消息ID;
返回结果
// 成功返回 { "result": true } // 失败返回 { "result": false, "error": "uid invalid", "error_code": "30006", "request":"/2/eps/template/send.json" }