Filtros de tiempo

Los siguientes puntos de entrada de la API permiten buscar registros según la fecha en que fueron creados:

• GET /posts

• GET /posts/stats

En cada uno de estos endpoints, dos parámetros trabajan juntos para especificar un rango de tiempo para los registros que se incluirán en los resultados:

• published_at_from – inicio del rango de tiempo.

• published_at_to – fin del rango de tiempo.

Expresión de un valor de tiempo

Los valores de tiempo utilizados con estos parámetros deben expresarse en una marca temporal Unix (Unix Epoch Timestamp).

Unix Epoch Timestamp

La marca temporal Unix debe expresarse como un número entero que representa la cantidad de segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970. Herramientas como epochconverter.com pueden ser útiles para convertir entre diferentes formatos de fecha y hora.

Por ejemplo, el mediodía UTC del 1 de enero de 2022 se representaría como 1641038400.

Opciones de rango de tiempo

Un rango de tiempo puede especificarse de las siguientes maneras:

• Especificar un inicio y un fin explícitos utilizando ambos parámetros.

• Especificar un inicio explícito y dejar el tiempo actual como el fin implícito del rango.

• Omitir ambos parámetros para aceptar un rango de tiempo predeterminado del sistema que cubre publicaciones recientes. A partir de noviembre de 2022, el rango de tiempo predeterminado del sistema abarca los últimos siete días de publicaciones recientes.

Es importante tener en cuenta que el uso del parámetro published_at_to sin el parámetro published_at_from no está soportado y puede generar resultados inesperados.

Rango explícito

La siguiente solicitud recuperará publicaciones desde el 1 de enero de 2022 a mediodía UTC hasta el mediodía UTC del día siguiente:

GET /posts?published_at_from=1641038400&published_at_to=1641124800

Inicio explícito del rango con fin implícito

Si se omite el parámetro published_at_to, el tiempo actual se considerará como el fin implícito del rango de tiempo. La siguiente solicitud recuperará publicaciones desde el 1 de enero de 2022 a mediodía UTC hasta el momento actual:

GET /posts?published_at_from=1641038400

Fin explícito del rango con inicio implícito

Si se omiten ambos parámetros published_at_to y published_at_from, se aplicará el rango de tiempo predeterminado de publicaciones recientes:

GET /posts