Modifica as configurações de callback de um aplicativo de mensagens interativas.
Descrição da operação
O limite desta API é de 50 chamadas por segundo por conta. O sistema descarta solicitações que excedem esse limite, o que pode causar interrupções no serviço. Considere essa restrição ao chamar esta operação.
Depuração
Informações de autorização
A tabela a seguir apresenta as informações de autorização correspondentes à API. Utilize essas informações no elemento de política Action para conceder as permissões necessárias a um usuário RAM ou função RAM e permitir a chamada desta operação. Descrição:
Operação: valor usado no elemento Action para especificar a ação sobre um recurso.
Nível de acesso: nível de acesso de cada operação. Os níveis disponíveis são leitura, escrita e listagem.
-
Tipo de recurso: tipo de recurso no qual o usuário RAM ou a função RAM recebe autorização para executar a operação. Observe os seguintes pontos:
Tipos de recurso obrigatórios usam o prefixo * .
Se não for possível conceder permissões no nível do recurso, a coluna Tipo de recurso da operação exibirá
All Resources.
Operação associada: outras operações que exigem permissão para que o usuário RAM ou a função RAM conclua a operação principal. A conclusão da tarefa requer permissões também nas operações associadas.
Chave de condição: chave definida pelo serviço de nuvem.
| Operação | Nível de acesso | Tipo de recurso | Chave de condição | Operação associada |
|---|---|---|---|---|
| live:ModifyLiveMessageAppCallback | atualize | *Rtc acs:live::{#accountId}:rtc/{#AppId} |
| none |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
|
AppId |
string |
Sim |
ID do aplicativo de mensagens interativas cujas configurações de callback serão modificadas. |
demo |
|
EventCallbackUrl |
string |
Não |
URL de callback para eventos como login, logout, entrada em grupo e saída de grupo. Se este parâmetro estiver vazio, os callbacks ficam desativados. A URL deve começar com http:// ou https:// e não pode conter endereço IP privado ou número de porta. |
http://example.aliyundoc.com/examplecallback |
|
DataCenter |
string |
Não |
Data center. Deve corresponder ao data center especificado na chamada da operação CreateLiveMessageApp para criar o aplicativo de mensagens interativas. Valores válidos: cn-shanghai e ap-southeast-1 (Singapura). |
cn-shanghai |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Descrição |
Exemplo |
|
object |
Parâmetros da resposta. |
||
|
RequestId |
string |
ID da solicitação. |
1F0FFEAD-B7D5-1D4A-A6B9-8C63ADF6**** |
|
AppId |
string |
ID do aplicativo de mensagens interativas. |
demo |
|
AppSign |
string |
Assinatura do aplicativo de mensagens interativas. Necessária para o SDK de mensagens interativas. |
**** |
|
EventCallbackUrl |
string |
URL de callback para eventos como login, logout, entrada em grupo e saída de grupo. Este parâmetro não é retornado quando possui valor vazio. |
http://example.aliyundoc.com/examplecallback |
|
EventCallbackNeedAuthentication |
boolean |
Indica se a autenticação é obrigatória para callbacks de eventos. Valor padrão: true. |
true |
Exemplos
Exemplos de respostas de sucesso
Formato JSON
{
"RequestId": "1F0FFEAD-B7D5-1D4A-A6B9-8C63ADF6****",
"AppId": "demo",
"AppSign": "****",
"EventCallbackUrl": "http://example.aliyundoc.com/examplecallback",
"EventCallbackNeedAuthentication": true
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InputInvalid |
%s. |
Parâmetros de entrada inválidos |
|
400 |
ErrorInvalidEventCallbackUrl |
%s. |
O EventCallbackUrl é inválido; verifique e tente novamente. |
|
403 |
NoAuth |
%s. |
Sem permissão |
|
404 |
ResourceNotExist |
%s. |
O recurso solicitado não existe; verifique e tente novamente |
|
500 |
ServerError |
%s. |
Erro desconhecido; tente novamente mais tarde ou envie um ticket para consulta. |
Para obter uma lista completa de códigos de erro, consulte os Códigos de erro do serviço.
Histórico de alterações
|
Data da alteração |
Resumo das alterações |
Operação |
|
2024-02-02 |
O código de erro foi alterado |