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

Solicitud

Método HTTP

POST

URL

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

Parámetros de URL

No hay parámetros disponibles

Encabezados

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

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

Especifique la clave API de alertas, que puede encontrar en su perfil. Esta clave es diferente de las claves de la API del canal y de la 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

Puedes usar el Accept encabezado para controlar el detalle proporcionado con los mensajes de error. Proporcionar la Accept encabezado con valor application/json,application/problem+json y el servidor devuelve 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

Usar 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. Selecciona el Headers pestaña. Introduzca estos pares de clave y valor.

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

  3. Ingrese la información del cuerpo. Selecciona el Body pestaña y seleccione raw. Introduzca 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.

Usar MATLAB® para generar una alerta cuando el valor medio en un canal está por encima de un umbral establecido. Este ejemplo usa ThingSpeak canal 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 MATLAB medio ambiente, incluyendo MATLAB Análisis y escritorio 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. Construir weboptions de modo que webwrite puede escribir apropiadamente su solicitud HTTP. También cree el cuerpo y el asunto del correo electrónico.

Sugerencia

Cuando crea una alerta en MATLAB usando webwrite , lo requerido Content-Type el encabezado 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. Puedes usar el Get Alert History Llamada API para rastrear el estado de su correo electrónico.

Ahora puede usar la aplicación TimeControl para programar este código para que se ejecute a intervalos regulares. Ir Apps > TimeControl y seleccione nuevo TimeControl. Selecciona el Frequency a Recurrente y Recurrence a 100 minutos. Selecciona el Action como MATLAB análisis y elija el nombre del MATLAB análisis que escribiste en el paso anterior. Guarde el control de tiempo.

Cuando la temperatura promedio supere los 60 ℉, recibirá 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 supera el límite de solicitudes, la API devuelve el código de respuesta 429.