Main Content

Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión en inglés.

Send Alert

Crear alerta de correo electrónico con HTTP POST

Pedido

Método HTTP

POST

URL

https://api.thingspeak.com/alerts/send

Parámetros de URL

No hay parámetros disponibles

Encabezados

Los encabezados ThingSpeak-Alerts-API-Key y Content-Type son obligatorios. El encabezado Accept es opcional.

NombrePrioridadDescripciónTipo de valor
ThingSpeak-Alerts-API-KeyRequerido

Especifique la clave API de alertas, que puede encontrar en su profile. Esta clave es diferente de las claves API del canal y API del usuario.

cadena

Content-TypeRequerido

  • application/json

  • application/x-www-form-urlencoded

cadena

Parámetros del cuerpo

NombrePrioridadDescripciónTipo de valor
subjectOpcional

Especifique el asunto del mensaje de correo electrónico, hasta 60 caracteres.

cadena

bodyOpcional

Especifique el cuerpo del mensaje de correo electrónico, hasta 500 caracteres.

cadena

Respuesta

Éxito

Código de estado HTTP

202 Accepted

Error

Puede utilizar el encabezado Accept para controlar los detalles proporcionados con los mensajes de error. Proporcione el encabezado Accept con el valor application/json,application/problem+json y el servidor devolverá mensajes de error detallados junto con el código de respuesta HTTP estándar.

Para obtener la lista completa de posibles errores HTTP, consulte Códigos de error.

Ejemplos

expandir todo

Utilice POSTMAN para realizar solicitudes HTTP utilizando la API RESTful para ThingSpeak.

Cree una alerta con un asunto y un cuerpo detallados.

  1. Cree la solicitud POST. En POSTMAN, seleccione POST de la lista de verbos HTTP e ingrese https://api.thingspeak.com/alerts/send en la barra de direcciones.

  2. Introduzca los encabezados. Seleccione la pestaña Headers . Introduzca estos pares de clave y valor.

    LlaveValor
    Thingspeak-Alerts-API-KeyXXXXXXXXXXXXXXXX
    Content-Typeapplication/json

  3. Ingrese la información del cuerpo. Seleccione la pestaña Body y seleccione raw. Ingrese este código JSON.

    {
        "subject": "ThingSpeak Alert email",
        "body": "The water level has reached its limit"
    }

La respuesta está en formato JSON. El valor de respuesta del servidor es 202 OK, lo que indica una solicitud aceptada. El correo electrónico se envía poco después.

Utilice MATLAB® para generar una alerta cuando el valor medio en un canal esté por encima de un umbral establecido. Este ejemplo utiliza ThingSpeak channel 276330, que contiene datos de temperatura de la oficina en vivo en el campo 7. Tenga en cuenta que puede escribir el siguiente código en cualquier entorno MATLAB , incluido MATLAB Análisis y MATLAB.

Configure la clave API de alertas y la URL para la solicitud. Su clave API de alertas se encuentra en Account > My Profile.

Lea los datos del canal y calcule el valor medio de los datos.

data = thingSpeakRead(276330,"NumMinutes", 100);
aveTemp = mean(data(:, 7));

Configure la clave API de alertas y la URL para la solicitud. Su clave API de alertas se encuentra en Account > My Profile.

apiKey = 'XXXXXXXXXXXXXXXX';
alertURL = "https://api.thingspeak.com/alerts/send";

La solicitud de envío de alertas requiere un encabezado de clave API. Compile weboptions para que webwrite pueda escribir adecuadamente su solicitud HTTP. También cree el cuerpo y el asunto del correo electrónico.

Sugerencia

Cuando crea una alerta en MATLAB usando webwrite, el encabezado Content-Type requerido se especifica automáticamente.

options = weboptions("HeaderFields", ["ThingSpeak-Alerts-API-Key", apiKey ]);
alertBody = sprintf("The temperature is %0.2f°F.", aveTemp);
alertSubject = sprintf("🌡 Temperature exceeded 60.0°F!");

Si la temperatura es superior a 60 °F, envíe una alerta.

if aveTemp > 60.0
    webwrite(alertURL, "body", alertBody, "subject", alertSubject, options);
end    

La marca de tiempo utilizada en el correo electrónico está en la zona horaria establecida en la configuración de ThingSpeak, que puede encontrar en Account > My Profile. Puede utilizar la llamada API Get Alert History para realizar un seguimiento del estado de su correo electrónico.

Ahora puede utilizar la aplicación TimeControl para programar la ejecución de este código a intervalos regulares. Vaya a Apps > TimeControl y seleccione el nuevo TimeControl. Establezca Frequency en Recurrente y Recurrence en 100 minutos. Seleccione el análisis Action como análisis MATLAB y elija el nombre del análisis MATLAB que escribió en el paso anterior. Guarde el control de tiempo.

Cuando la temperatura promedio supere los 60 ℉, recibirás un correo electrónico de ThingSpeak.

Limitaciones

  • Los usuarios están limitados a 2 alertas cada 30 minutos. El límite de tarifa se aplica cuando se realiza la solicitud, no cuando se envía el correo electrónico. Si excede el límite de solicitudes, la API devuelve el código de respuesta 429.