Skip to main content
Todos los endpoints de listado comparten las mismas convenciones de paginación, ordenamiento, selección de campos y filtrado.

Paginación

Las listas se paginan con dos parámetros de consulta: take=all devuelve el tamaño máximo de página en una sola página. El campo data de una respuesta paginada contiene:

Selección de campos

Envía fields con una lista separada por comas para devolver únicamente los campos que necesitas:

Ordenamiento

Envía sort con nombres de campo separados por comas. Antepón - a un campo para orden descendente:

Filtros

Filtra las listas con parámetros de consulta con la forma campo__operador=valor. Varios filtros se combinan con AND por defecto. Dos prefijos modifican cómo se combina una condición:
  • or__ — combina la condición con OR en lugar de AND: or__status__exact=draft
  • not__ — niega la condición: not__status__exact=cancelled
Los filtros apuntan a los campos de la entidad que estás consultando, incluidos los campos relacionados con la forma related__field cuando la entidad los expone. Filtrar por un campo que la entidad no tiene devuelve un error de validación.