Get Subscriptions
The following endpoint can be used to retrieve the details of Subscriptions within the Trace AR application.
Punto Final
The following endpoint can be used to retrieve Subscriptions. You must replace the {base_url} , {site_id} and {updated_after} variables with the appropriate values.
GET
{base_url}/api/v4/site/{site_id}/subscriptions?updated_after={updated_after}
Solicitar parámetros de consulta
Campo
Tipo
Descripción
updated_after
Date
Un sello de tiempo que se utilizará como el inicio del rango de fechas (exclusivo) de la consulta. En solicitudes posteriores, debes pasar el valor nextUpdatedAfter que estaba en la respuesta de la solicitud anterior. Las consultas buscan hacia atrás un máximo de 7 días. Una marca de tiempo más antigua se adelanta al límite en lugar de rechazarse, por lo que no se devuelven los registros que cambiaron por última vez antes de ese límite. Si se omite este parámetro, se devuelven los últimos 7 días. Una integración que devuelve el nextUpdatedAfter de cada respuesta nunca alcanza el límite. Format = YYYY-MM-DDTHH:mm:ss.SSSZ
Respuesta
Campo
Tipo
Descripción
recordsMatched
Number
El número de registros que coincidieron con los parámetros de la consulta.
recordsReturned
Number
El número de registros que fueron devueltos.
nextUpdatedAfter
Date
Un sello de tiempo que se utilizará como el inicio del rango de fechas (exclusivo) de la próxima consulta para el mismo punto final. Esto se utiliza para la paginación al consultar con un parámetro updated_after. Format = YYYY-MM-DDTHH:mm:ss.SSSZ
queryTime
Date
La hora en que se ejecutó la consulta. nextUpdatedAfter se deriva de ella, por lo que es el mismo valor siempre que se devolvió una página completa. Format = YYYY-MM-DDTHH:mm:ss.SSSZ
limit
Number
El número máximo de registros que devolverá una sola respuesta. Cuando recordsReturned es igual a este valor, es probable que haya más registros en espera y se debe hacer otra solicitud con el nextUpdatedAfter devuelto.
records
La lista de contactos que coinciden con los parámetros de la consulta.
success
Boolean
Indica si la consulta se completó correctamente.