Todos los productos
Search
Centro de documentos

Direct Mail:Guía del SDK

Última actualización: Sep 03, 2026

Use OpenAPI Explorer para invocar operaciones de la API de Direct Mail, depurarlas y generar código de ejemplo del SDK.

Use OpenAPI Explorer para buscar, depurar y generar código de ejemplo de las operaciones de la API de Direct Mail.

Proceso básico:

1. Vaya a la página de OpenAPI Explorer

Ejemplo: enviar un correo electrónico.

Enviar un correo electrónico (depuración y consulta de código de ejemplo)

Envío de un solo correo electrónico:

Depure y consulte el código de ejemplo:

https://api.alibabacloud.com/api/Dm/2015-11-23/SingleSendMail

Nota

Se admiten llamadas en bucle y concurrentes.

Una sola solicitud admite hasta 100 direcciones de destinatario. Consulte otros parámetros en SingleSendMail.

Envío de correos electrónicos por lotes:

Depure y consulte el código de ejemplo:

https://api.alibabacloud.com/api/Dm/2015-11-23/BatchSendMail

Nota

Use una plantilla y una lista de destinatarios creadas en la consola o mediante la API para enviar correos electrónicos por lotes. Consulte otros parámetros en BatchSendMail.

2. Busque operaciones de la API y especifique los parámetros

Use la versión predeterminada de la API 2015-11-23. El identificador de versión se mantiene igual aunque las operaciones de la API reciban actualizaciones continuas.

imagen

Consulte la documentación de la operación de la API:

imagen

3. Seleccione un lenguaje de programación para la depuración

Seleccione un lenguaje de programación y haga clic en "Initiate Call".

imagen

4. Genere código de ejemplo

Método 1: Uso del SDK de Direct Mail

Obtenga el comando de instalación del SDK

Tras realizar una prueba exitosa, instale el SDK en su computadora local o servidor.

La sección "SDK Info" muestra la versión del SDK y el comando de instalación.

imagen

imagen

Método 2: Uso de CommonRequest

Cambie a "Generate code in Common mode". De forma predeterminada, los parámetros se pasan en el cuerpo de la solicitud para evitar límites de longitud de URL.

imagen

Ejemplo en C#:

The "Invalid URI: The Uri string is too long" error is reported when you use the C# SDK to send long content

Referencias:

Java generalized calls 1.0 (se descontinuará)

Java generalized calls 2.0

Preguntas frecuentes

¿Cómo creo un AccessKey?

Si inicia sesión con su cuenta de Alibaba Cloud, la página de depuración no requiere clave. No obstante, debe configurar la clave en su código para el despliegue local o en servidor.

También puede usar un par de AccessKey creado en RAM.

  1. Inicie sesión en la consola de administración de AccessKey.

  2. En la esquina superior derecha, haga clic en Create AccessKey.

  3. Lea el mensaje y haga clic en OK.

Aviso

No codifique directamente los valores "accessKeyId" y "accessKeySecret" en su código para evitar fugas.

Los SDK de Alibaba Cloud admiten las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET para la autenticación, como se describe en Configuración de verificación de identidad.

Error SignatureDoesNotMatch

SignatureDoesNotMatch

Mensaje: La firma especificada no coincide con nuestro cálculo.

  1. Si usa un mecanismo de firma propio, compruebe que el orden de los parámetros y la codificación sean correctos. Use el SDK de Direct Mail para simplificar el proceso de firma.

  2. Compruebe si el secreto de AccessKey es incorrecto.

Mensaje de error para un ID de AccessKey incorrecto: Specified access key is not found.

Mensaje de error para un secreto de AccessKey incorrecto: Specified signature is not matched with our calculation.

  1. Compruebe la diferencia horaria del sistema.

Verifique que la hora de su sistema no difiera de la del servidor por más de 15 minutos.

Si su sistema se encuentra en una zona horaria distinta, sincronícelo con UTC+8.

Comandos para consultar la hora del sistema

Windows:

echo %date% %time%
tzutil /g

Mac:

date
systemsetup -gettimezone