文档

发送消息到用户

调用SendLiveMessageUser发送消息到用户。

QPS限制

本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称

类型

是否必选

示例值

描述

Action String SendLiveMessageUser

系统规定参数。取值:SendLiveMessageUser

AppId String demo

发送消息的互动消息应用ID。

ReceiverId String uid2

接收消息的用户ID,由大小写字母、数字组成,长度不超过64字节。

SenderId String uid1

发送消息的用户ID,由大小写字母、数字组成,长度不超过64字节。

SenderInfo String uid1meta1

发送消息用户的扩展信息,长度不超过512字节。

Body String hello, user

消息体,长度不超过15KB。

MsgType Long 2

消息类型。

MsgTid String 169830****

消息唯一标识,可作为删除消息的依据。由大小写字母、数字组成,长度不超过64字节。

DataCenter String cn-shanghai

数据中心,需要与CreateLiveMessageApp中的数据中心一致,当前支持上海(取值为cn-shanghai)、新加坡(取值为ap-southeast-1)。

返回数据

名称

类型

示例值

描述

RequestId String 6CFDE7AB-571A-14EA-B072-989FF753****

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=SendLiveMessageUser
&AppId=demo
&ReceiverId=uid2
&SenderId=uid1
&SenderInfo=uid1meta1
&Body=hello, user
&MsgType=2
&MsgTid=169830****
&DataCenter=cn-shanghai
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SendLiveMessageUserResponse>
    <RequestId>6CFDE7AB-571A-14EA-B072-989FF753****</RequestId>
</SendLiveMessageUserResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6CFDE7AB-571A-14EA-B072-989FF753****"
}

错误码

HttpCode

错误码

错误信息

描述

400 InputInvalid %s. 输入参数不合法
403 NoAuth %s. 没有权限
404 ResourceNotExist %s. 请求资源不存在,请检查后重新尝试
500 ServerError %s. 未知错误,请稍后重试或提交工单咨询。

访问错误中心查看更多错误码。

  • 本页导读 (1)