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

Obtener historial de alertas con HTTP GET

expandir todo en la página

Pedido

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 que se devolverán. El valor predeterminado es 10, el valor máximo es 100.
`after`	Opcional	Incluya solo elementos del historial con `requested_at` posteriores a este tiempo. Tiempos de formato según ISO 8601. Por ejemplo, 2020-05-15T20:03:48-05:00 representa el 15 de mayo de 2020 a las 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 los cuales ya no están disponibles.
`before`	Opcional	Incluya solo elementos del historial con `requested_at` anteriores a este momento. Tiempos de formato según ISO 8601. Por ejemplo, 2020-05-15T20:03:48-05:00 representa el 15 de mayo de 2020 a las 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 los cuales ya no están disponibles.
`subject_contains`	Opcional	Incluya solo elementos del historial cuyo asunto contenga este valor, distinguiendo entre mayúsculas y minúsculas.
`status`	Opcional	Incluya solo 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 profile. Esta clave es diferente de las claves API del canal y 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

Puede utilizar el encabezado Accept para controlar los detalles proporcionados con los mensajes de error. Proporcione el encabezado Accept y la clave 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

Ver historial de alertas usando MATLAB

Puede utilizar 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 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.

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

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

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

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

myHistoryStruct = webread(history_url, options);

La solicitud web devuelve una estructura. Utilice struct2table (MATLAB), datetime (MATLAB) y table2timetable (MATLAB) para reescribir el resultado en un formulario 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'}