Atualizar um canal - Qoder CN Series: Central de Documentação do Alibaba Cloud

Atualize a vinculação, o nome de exibição, o status de ativação ou as opções de resposta de um canal.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Content-Type`	Sim	`application/json`
`Idempotency-Key`	Não	Chave de idempotência opcional para requisições não seguras.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`channel_id`	string	Sim	ID do canal.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`name`	string	Não	Nome de exibição do canal.
`identity_id`	string	Não	ID da Forward Identity para vincular.
`template_id`	string	Não	ID do Forward Template para vincular.
`enabled`	boolean	Não	Ativa ou desativa o canal manualmente.
`channel_config.credentials`	object	Não	Credenciais atualizadas do canal para rotação de credenciais.
`channel_config.response_options`	object	Não	Configurações de visibilidade das respostas.

Exemplo de requisição

curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/channels/ci_019eabc123' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "channel_config": {
      "response_options": {
        "include_tool_calls": true,
        "include_thinking": false
      }
    }
  }'

Exemplo de resposta

HTTP 200 OK

{
  "id": "ci_019eabc123",
  "type": "channel",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "channel_type": "feishu",
  "name": "Support Feishu channel",
  "enabled": false,
  "binding_status": "bound",
  "channel_config": {
    "response_options": {
      "include_tool_calls": true,
      "include_thinking": false
    }
  },
  "created_at": "2026-06-18T10:00:00Z",
  "updated_at": "2026-06-18T10:30:00Z"
}

Campos da resposta

Retorna o objeto Channel atualizado.

Erros

HTTP	Tipo	Código	Gatilho
400	`invalid_request_error`	`invalid_request`	Corpo da requisição inválido.
404	`not_found_error`	`channel_not_found`	Canal especificado não existe.
404	`not_found_error`	`channel_template_not_found`	Modelo especificado não existe.
404	`not_found_error`	`channel_identity_not_found`	Identidade especificada não existe.
409	`conflict_error`	`channel_identity_disabled`	Identidade especificada está desativada.
401	`authentication_error`	`authentication_required`	PAT inválido ou expirado.

Observações

Os campos id, type e channel_type não podem ser atualizados.
O sistema gerencia automaticamente o campo binding_status.
Definir enabled=true apenas aciona a chave manual, sem alterar o binding_status.
A atualização de identity_id ou template_id encerra as conversas ativas antigas do canal; novas mensagens recebidas usam a nova vinculação.

Cabeçalhos da requisição

Parâmetros de caminho

Corpo da requisição

Exemplo de requisição

Exemplo de resposta

Campos da resposta

Erros

Observações

APIs relacionadas