修改互动消息应用回调信息

调用ModifyLiveMessageAppCallback修改互动消息应用回调信息。

QPS限制

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

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String ModifyLiveMessageAppCallback

系统规定参数。取值:ModifyLiveMessageAppCallback

AppId String demo

需要修改的互动消息应用ID。

EventCallbackUrl String http://example.aliyundoc.com/examplecallback

用户登录、登出、加入、离开群组等事件回调地址。若为空则不开启回调。事件回调地址以http://或https://开头,不包含私有IP,不允许带端口号。

DataCenter String cn-shanghai

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

返回数据

名称

类型

示例值

描述

RequestId String 1F0FFEAD-B7D5-1D4A-A6B9-8C63ADF6****

请求ID。

AppId String demo

修改回调的互动消息应用ID。

AppSign String **************************************************************************

互动消息应用签名,互动消息服务SDK需要该信息。

EventCallbackUrl String http://example.aliyundoc.com/examplecallback

用户登录、登出、加入、离开群组等事件回调地址。若为空则不返回。

EventCallbackNeedAuthentication Boolean true

事件回调是否需要鉴权。默认为true。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=ModifyLiveMessageAppCallback
&AppId=demo
&EventCallbackUrl=http://example.aliyundoc.com/examplecallback
&DataCenter=cn-shanghai
&<公共请求参数>

正常返回示例

XML格式

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

<ModifyLiveMessageAppCallbackResponse>
    <RequestId>1F0FFEAD-B7D5-1D4A-A6B9-8C63ADF6****</RequestId>
    <AppId>demo</AppId>
    <AppSign>**************************************************************************</AppSign>
    <EventCallbackUrl>http://example.aliyundoc.com/examplecallback</EventCallbackUrl>
    <EventCallbackNeedAuthentication>true</EventCallbackNeedAuthentication>
</ModifyLiveMessageAppCallbackResponse>

JSON格式

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

{
  "RequestId" : "1F0FFEAD-B7D5-1D4A-A6B9-8C63ADF6****",
  "AppId" : "demo",
  "AppSign" : "**************************************************************************",
  "EventCallbackUrl" : "http://example.aliyundoc.com/examplecallback",
  "EventCallbackNeedAuthentication" : true
}

错误码

HttpCode

错误码

错误信息

描述

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

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