调用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. | 未知错误,请稍后重试或提交工单咨询。 |
访问错误中心查看更多错误码。
文档内容是否对您有帮助?