模板消息
| （未显示2个用户的12个中间版本） | |||
| 第1行： | 第1行： | ||
| − | = | + | =模板消息= |
| − | + | 模板消息仅用于向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。 | |
| − | |||
| − | + | 调用API接口发送模板消息之前，需要先在粉服管理后台申请模板ID； | |
| − | + | ||
| + | |||
| + | 说明：申请模板消息遇到问题可邮件 [mailto:chujie@staff.sina.com.cn chujie@staff.sina.com.cn] 。 | ||
| − | |||
==URL== | ==URL== | ||
| − | + | https://api.weibo.com/2/eps/template/send.json | |
==HTTP请求方式== | ==HTTP请求方式== | ||
POST | POST | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==接口请求参数== | ==接口请求参数== | ||
| 第30行： | 第25行： | ||
{{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} | {{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} | ||
{{api_args|receiver_id|true|long|消息接收方的ID。}} | {{api_args|receiver_id|true|long|消息接收方的ID。}} | ||
| − | {{api_args|template_id| | + | {{api_args|template_id|true|string|用户模板的ID，utid。}} |
| − | {{api_args|data|true|string| | + | {{api_args|data|true|string|要发给用户的数据，json格式，还需补充该json格式的说明文档}} |
| − | + | {{api_args|url|false|string|如果是发送纯文本格式的消息，则无需该字段}} | |
| + | {{api_args|topcolor|false|string|消息顶部颜色，如果是发送纯文本格式的消息，则无需该字段}} | ||
|} | |} | ||
| − | |||
==注意事项== | ==注意事项== | ||
| − | * | + | *1、请求示例：https://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、模板消息有两类； | ||
| + | 一类是纯文本格式的模板消息，这类模板消息无需用到url和topcolor参数； | ||
| + | 一类是卡片格式的模板消息，其格式如下： | ||
==返回结果== | ==返回结果== | ||
2022年11月17日 (四) 11:34的最后版本
模板消息
模板消息仅用于向用户发送重要的服务通知，只能用于符合其要求的服务场景中，如信用卡刷卡通知，商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。
调用API接口发送模板消息之前，需要先在粉服管理后台申请模板ID；
说明：申请模板消息遇到问题可邮件 chujie@staff.sina.com.cn 。
URL
https://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 | true | string | 用户模板的ID，utid。 |
| data | true | string | 要发给用户的数据，json格式，还需补充该json格式的说明文档 |
| url | false | string | 如果是发送纯文本格式的消息，则无需该字段 |
| topcolor | false | string | 消息顶部颜色，如果是发送纯文本格式的消息，则无需该字段 |
注意事项
- 1、请求示例：https://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、模板消息有两类；
一类是纯文本格式的模板消息，这类模板消息无需用到url和topcolor参数； 一类是卡片格式的模板消息，其格式如下：
返回结果
// 成功返回
{
"result": true
}
// 失败返回
{
"result": false,
"error": "uid invalid",
"error_code": "30006",
"request":"/2/eps/template/send.json"
}
文档更新时间: 2022-11-17
