Main Content

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

Get Alert History

Obtén el historial de alertas con HTTP GET

Solicitud

Método HTTP

GET

URL

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

Parámetros de URL

NombrePrioridadDescripción

count

Opcional

El número de resultados a devolver. El valor predeterminado es 10, el valor máximo es 100.

after

OpcionalIncluir solo elementos del historial con requested_at más tarde que esta vez. Tiempos de formato según ISO 8601. Por ejemplo, 2020-05-15T20:03:48-05:00 representa el 15 de mayo de 2020, 20:03:48 EST. Si no incluye el desplazamiento de la zona horaria, ThingSpeak asume que la hora especificada está en UTC. Nota: Los elementos del historial de alertas se conservan solo durante 7 días, después de lo cual ya no están disponibles.

before

OpcionalIncluir solo elementos del historial con requested_at antes de esta hora. Tiempos de formato según ISO 8601. Por ejemplo, 2020-05-15T20:03:48-05:00 representa el 15 de mayo de 2020, 20:03:48 EST. Si no incluye el desplazamiento de la zona horaria, ThingSpeak asume que la hora especificada está en UTC. Nota: Los elementos del historial de alertas se conservan solo durante 7 días, después de lo cual ya no están disponibles.

subject_contains

OpcionalIncluya solo elementos del historial con un asunto que contenga este valor, distinga entre mayúsculas y minúsculas.

status

OpcionalIncluya solo los elementos del historial cuyo estado contenga este valor.

Ejemplo: https://api.thingspeak.com/alerts/history?count=10

Encabezados

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

Parámetros del cuerpo

No hay parámetros de cuerpo disponibles para esta llamada API.

Respuesta

Éxito

Código de estado HTTP

200 OK

Error

Puedes usar el Accept encabezado para controlar el detalle proporcionado con los mensajes de error. Proporcionar la Accept encabezado y clave 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

Puedes usar MATLAB® para leer su historial de alertas de los últimos 7 días. Este ejemplo muestra cómo realizar una solicitud HTTP para generar su historial de alertas. 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.

apiKey = 'XXXXXXXXXXXXXXXX';
history_url = "https://api.thingspeak.com/alerts/history"

La solicitud de envío de alertas requiere un encabezado de clave API. Construir weboptions de modo que webread puede escribir apropiadamente su solicitud HTTP. También cree el cuerpo y el asunto del correo electrónico.

options = weboptions("HeaderFields", ["ThingSpeak-Alerts-API-Key", apiKey ]);

Usar webread (MATLAB) para realizar la solicitud de obtención de historial.

myHistoryStruct = webread(history_url, options);

La solicitud web devuelve una estructura. Usar struct2table (MATLAB) , datetime (MATLAB) , y table2timetable (MATLAB) para reescribir la salida en una forma más fácil de ver.

history = struct2table(myHistoryStruct, "AsArray", true);
history.requestedAt = datetime(history.requestedAt, 'InputFormat', "uuuu-MM-dd'T'HH:mm:ss.SSSz", 'TimeZone',"America/New_York");
history = table2timetable(history)
history =

  2×3 timetable

        requestedAt                    sentAt                        subject               status 
    ____________________    ____________________________    __________________________    ________

    18-Dec-2019 13:46:48    {'2019-12-18T18:46:54.160Z'}    {'Plant soil information'}    {'sent'}
    18-Dec-2019 13:43:36    {'2019-12-18T18:43:42.032Z'}    {'Plant soil information'}    {'sent'}