Todos los productos
Search
Centro de documentos

:QueryMailAddressByParam

Última actualización: Sep 03, 2026

Llame a la operación QueryMailAddressByParam para consultar una lista de direcciones de remitente.

Prueba

Llame a esta operación directamente en OpenAPI Explorer. Esto evita tener que calcular firmas. Tras una llamada correcta, OpenAPI Explorer genera automáticamente ejemplos de código del SDK.

Parámetros de solicitud

Nombre

Tipo

Obligatorio

Descripción

Action

String

Sí

Parámetro obligatorio. Establezca el valor en QueryMailAddressByParam.

PageNo

String

No

Número de página. Valor predeterminado: 1.

PageSize

String

No

Número de entradas por página. Valor predeterminado: 10.

KeyWord

String

Sí

Dirección de correo electrónico. La dirección puede tener entre 1 y 60 caracteres y contener dígitos, letras, puntos (.), guiones (-) y arrobas (@).

Sendtype

String

No

Tipo de dirección de correo electrónico. Valores válidos: batch y trigger. Si no especifica este parámetro, se mostrarán todos los tipos de direcciones de correo electrónico.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Common parameters.

Parámetros de respuesta

Nombre

Tipo

Descripción

data

data

data

Nombre

Tipo

Descripción

data

Array

registro de datos

Registro de datos

Nombre

Tipo

Descripción

mailAddressId

int

ID de la dirección del remitente.

accountName

String

Dirección del remitente.

replyAddress

String

Dirección de respuesta.

sendtype

String

Tipo de dirección del remitente. Valores válidos: batch y trigger.

accountStatus

int

Estado de la cuenta. Valores válidos: 0: Normal. 1: Bloqueado.

replyStatus

int

Estado de la dirección de respuesta.

createTime

Date

dailyCount

int

Límite de la cuota de envío diaria.

monthCount

int

Límite de la cuota de envío mensual.

dailyReqCount

int

Cuota de envío diaria.

monthReqCount

int

Cuota de envío mensual.

domainStatus

int

Estado del dominio. Valores válidos: 0: Normal. 1: Anómalo.

Para obtener más información sobre los parámetros de respuesta comunes, consulte Common parameters.

Ejemplos

Ejemplo de solicitud

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

Ejemplo de respuesta correcta

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 error

Para consultar una lista de códigos de error, visite el Centro de errores.