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

expandir todo en la página

Solicitud

Método HTTP

GET

URL

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

Parámetros de URL

Nombre	Prioridad	Descripción
`count`	Opcional	El número de resultados a devolver. El valor predeterminado es 10, el valor máximo es 100.
`after`	Opcional	Incluir 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`	Opcional	Incluir 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`	Opcional	Incluya solo elementos del historial con un asunto que contenga este valor, distinga entre mayúsculas y minúsculas.
`status`	Opcional	Incluya solo los elementos del historial cuyo estado contenga este valor.

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

Encabezados

Nombre	Prioridad	Descripción	Tipo de valor
`ThingSpeak-Alerts-API-Key`	Requerido	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

Ver historial de alertas usando MATLAB

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'}