主动发送私信
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/im/authorize/send/msg/
使用限制
接口说明
小程序通过平台试运营期后默认获得该能力。注:关于小程序试运营期介绍详情请查看小程序试运营说明。
需要用户授权
content 构造
文本 content
图片 content
视频 content
群聊邀请卡片 content
小程序引导卡片 content
名称 | 类型 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
path | string | true | 通过URL Link进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带 query。path 为空时会跳转小程序主页。 | api/apiPage/apiPage |
query | string | true | 通过URL Link进入小程序时的 query(json形式),若无请填{}。最大1024个字符,只支持数字,大小写英文以及部分特殊字符:{}!#$&'()*+,/:;=?@-._~%`。 | {"id":"hebbch"} |
app_id | string | true | 小程序ID | tt3ergjdge84gdwksb |
1.
2.
小程序券 content
服务私信授权卡片 content
请求示例
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/im/authorize/send/msg/?open_id=aa-aa-aa' \
--header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ec' \
--header 'Content-Type: application/json' \
--data-raw '{
"content": {
"msg_type": 2,
"image": {
"media_id": "@aaaa"
}
},
"to_user_id": "bb-bb-xx"
}'
响应示例响应示例
{
"err_msg":"",
"err_no":0,
"data":{
"msg_id":"@c29bfc000+MNggFhRkwGuX1ntuc0RPc0VHKefj/yWEJ8DtjU=="
},
"log_id":"11111"
}
请求参数
Query 参数
open_id
string
必需
示例值:
aa-aa-aa
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ(与移动应用获取方式一致)
示例值:
act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ec
Body 参数application/json