Ordenamiento

Todos los endpoints de listado aceptan un parámetro de consulta sort opcional, que define el orden de los registros devueltos.

Sintaxis

El parámetro sort es un array JSON con exactamente dos elementos: el nombre del campo y la dirección.

sort=["name","DESC"]

• El campo debe ser uno de los campos enumerados en la sección Campos de ordenamiento del endpoint.
• La dirección es ASC (ascendente) o DESC (descendente), y no distingue mayúsculas de minúsculas.

Los resultados se pueden ordenar por un único campo. Cuando dos o más registros tienen el mismo valor en el campo de ordenamiento, la API aplica un segundo campo de ordenamiento fijo (normalmente el nombre o el ID del registro, en la misma dirección), para que el orden sea siempre estable. Esto es importante al paginar, ya que garantiza que ningún registro se omita o se repita entre páginas.

Orden predeterminado

Cuando se omite sort, los resultados se ordenan por el campo predeterminado del endpoint, en orden ascendente. El campo predeterminado se indica en la sección Campos de ordenamiento de cada endpoint de listado. Por ejemplo, las campañas se ordenan por name, y el detalle de llamadas se ordena por startedAtLocal.

Errores

Se devuelve un error 400 Bad Request cuando:

• El array no contiene exactamente dos elementos.
• La dirección no es ASC ni DESC.
• El campo no es un campo de ordenamiento válido para el endpoint. El mensaje de error incluye la lista de campos válidos.