Parámetros de Consulta

Introducción

Los parámetros de consulta (query parameters) permiten filtrar, ordenar y paginar las respuestas de la API, asegurando una recuperación eficiente de los datos. Esta guía explica cómo utilizarlos en las solicitudes a la API de Passport y cómo se integran con la paginación.

Estructura de los Parámetros de Consulta

Los parámetros de consulta se agregan al final de la URL del endpoint como pares clave-valor, separados por el signo &.

JSON
Copy

Parámetros de Consulta Soportados

Los parámetros de consulta a continuación pueden ser utilizados para ordenamiento, filtros y la paginación:

Parámetros de Paginación

ParámetroDescripción
page_sizeNúmero de resultados por página. El valor por defecto varía según el endpoint.
page_numberNúmero de página actual. El valor por defecto es 1.

Ordenamiento

ParámetroDescripción
order_keyCampo por el cual se desea ordenar (ej. created_at, updated_at).
order_directionDirección del ordenamiento: asc (ascendente) o desc (descendente). Por defecto: asc.

Filtrado por Fecha

ParámetroDescripción
created_atFiltra por una fecha de creación exacta.
created_fromFiltra resultados creados después de esta fecha.
created_toFiltra resultados creados antes de esta fecha.
updated_atFiltra por una fecha de actualización exacta.
updated_fromFiltra resultados actualizados después de esta fecha.
updated_toFiltra resultados actualizados antes de esta fecha.

Todas las fechas deben estar en formato ISO 8601 (YYYY-MM-DDTHH:MM:SSZ).

Filtrado Específico

ParámetroDescripción
customer_idFiltra resultados por un ID de cliente específico.
customer_statusFiltra clientes por su estado (active, inactive).
emailFiltra resultados por dirección de correo exacta.
mobileFiltra por número de teléfono móvil.

Ejemplos de Solicitud

Paginación

JSON
Copy

Ordenamiento por Fecha de Creación en Orden Descendente

JSON
Copy

Filtro por Rango de Fechas de Creación

JSON
Copy

Buenas Prácticas al Usar Parámetros de Consulta

  • Utiliza paginación (page_size y page_number) para evitar sobrecargar la API.
  • Filtra por fecha (created_from y created_to) para búsquedas eficientes.
  • Ordena los resultados (order_key, order_direction) para mantener respuestas estructuradas.
  • Combina múltiples filtros para obtener resultados más precisos.
  • Valida los parámetros antes de enviar la solicitud para evitar errores de formato.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard