Todos os produtos
Search

Este produto

    Qoder CN Series:Listar canais

    Central de documentação

    Qoder CN Series:Listar canais

    Última atualização: Jul 15, 2026

    Liste canais de IM externos com filtros e paginação por cursor.

    Cabeçalhos da requisição

    Cabeçalho

    Obrigatório

    Descrição

    Authorization

    Sim

    Bearer <PAT>

    Parâmetros de consulta

    Parâmetro

    Tipo

    Obrigatório

    Padrão

    Descrição

    channel_type

    string

    Não

    -

    Filtra por wechat, qq, wecom, feishu ou dingtalk.

    enabled

    boolean

    Não

    -

    Filtra pelo status de ativação manual.

    binding_status

    string

    Não

    -

    Filtra por unbound, bound ou expired.

    identity_id

    string

    Não

    -

    Filtra pelo ID da identidade de encaminhamento.

    template_id

    string

    Não

    -

    Filtra pelo ID do modelo de encaminhamento.

    limit

    integer

    Não

    20

    Itens por página. Máximo de 100.

    after_id

    string

    Não

    -

    Cursor para registros posteriores ao ID do canal especificado.

    before_id

    string

    Não

    -

    Cursor para registros anteriores ao ID do canal especificado.

    Exemplo de requisição

    curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/channels?identity_id=idn_019eabc123&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

    Exemplo de resposta

    HTTP 200 OK

    {
  "data": [
    {
      "id": "ci_019eabc123",
      "type": "channel",
      "identity_id": "idn_019eabc123",
      "template_id": "tmpl_support",
      "channel_type": "feishu",
      "name": "Support Feishu channel",
      "enabled": true,
      "binding_status": "bound",
      "created_at": "2026-06-18T10:00:00Z",
      "updated_at": "2026-06-18T10:00:00Z"
    }
  ],
  "first_id": "ci_019eabc123",
  "last_id": "ci_019eabc123",
  "has_more": false
}

    Campos da resposta

    Campo

    Tipo

    Descrição

    data

    array

    Objetos de canal na página atual.

    first_id

    string\

    null

    ID do primeiro canal nesta página.

    last_id

    string\

    null

    ID do último canal nesta página.

    has_more

    boolean

    Indica se há mais registros disponíveis.

    Erros

    HTTP

    Tipo

    Código

    Gatilho

    400

    invalid_request_error

    invalid_pagination

    Parâmetros de paginação inválidos.

    400

    invalid_request_error

    channel_type_unsupported

    Filtro de tipo de canal não compatível.

    401

    —

    TOKEN_INVALID

    PAT inválido ou expirado.

    Observações

    • Os parâmetros after_id e before_id são mutuamente exclusivos.

    • A API retorna apenas canais dentro dos limites da conta do solicitante.