Todos os produtos
Search
Central de documentação

:QueryMailAddressByParam

Última atualização: Jun 27, 2026

Use a operação QueryMailAddressByParam para consultar uma lista de endereços de remetente.

Teste

Chame essa operação diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após uma chamada bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código do SDK.

Parâmetros da solicitação

Nome

Tipo

Obrigatório

Descrição

Action

String

Sim

Parâmetro obrigatório. Defina o valor como QueryMailAddressByParam.

PageNo

String

Não

Número da página. Valor padrão: 1.

PageSize

String

Não

Quantidade de entradas retornadas por página. Valor padrão: 10.

KeyWord

String

Sim

Endereço de e-mail. O endereço deve ter entre 1 e 60 caracteres e pode conter dígitos, letras, pontos (.), hifens (-) e arrobas (@).

Sendtype

String

Não

Tipo do endereço de e-mail. Valores válidos: batch e trigger. Caso esse parâmetro não seja especificado, a resposta incluirá todos os tipos de endereços de e-mail.

Para obter mais informações sobre parâmetros comuns de solicitação, consulte Parâmetros comuns.

Parâmetros de resposta

Nome

Tipo

Descrição

data

data

data

Nome

Tipo

Descrição

data

Array

Registro de dados

Registro de dados

Nome

Tipo

Descrição

mailAddressId

int

ID do endereço de remetente.

accountName

String

Endereço de remetente.

replyAddress

String

Endereço de resposta.

sendtype

String

Tipo do endereço de remetente. Valores válidos: batch e trigger.

accountStatus

int

Status da conta. Valores válidos: 0: Normal. 1: Congelada.

replyStatus

int

Status do endereço de resposta.

createTime

Date

dailyCount

int

Cota diária de envio.

monthCount

int

Cota mensal de envio.

dailyReqCount

int

Contagem diária de envios.

monthReqCount

int

Contagem mensal de envios.

domainStatus

int

Status do domínio. Valores válidos: 0: Normal. 1: Anormal.

Para obter mais informações sobre parâmetros comuns de resposta, consulte Parâmetros comuns.

Exemplos

Exemplo de solicitação

http(s)://dm.aliyuncs.com/?Action=QueryMailAddressByParam
&KeyWord=xxx
&Sendtype=batch
&PageNo=1
&PageSize=2
&<Common request parameters>

Exemplo de resposta bem-sucedida

Formato JSON

{
  "TotalCount": 2,
  "RequestId": "13EC32FA-61EB-5401-AB59-EA943CF25F14",
  "PageSize": 1,
  "data": {
    "mailAddress": [
      {
        "Sendtype": "batch",
        "AccountStatus": 0,
        "ReplyStatus": 0,
        "DailyReqCount": 0,
        "CreateTime": "2021-05-13T15:54Z",
        "MonthReqCount": 0,
        "ReplyAddress": "xxxxx",
        "MailAddressId": 237915,
        "MonthCount": -1,
        "DailyCount": -1,
        "DomainStatus": 0,
        "AccountName": "xxxxx"
      }
    ]
  },
  "PageNumber": 1
}

Códigos de erro

Para obter a lista de códigos de erro, consulte o Error Center.