Skip to main content
Todos los endpoints de lista /v1 devuelven el mismo envoltorio y paginan de la misma manera: basada en tokens y solo hacia adelante.

El envoltorio de lista

string
Siempre "list".
array
La página de recursos, en un orden estable y determinista.
string | null
Pase este valor como page_token en la siguiente solicitud para obtener la página siguiente. null cuando no haya más resultados.
boolean
Indica si existen más resultados después de esta página.

Parámetros de la solicitud

integer
predeterminado:"25"
Tamaño de página. Un número entero entre 1 y 500. Los valores fuera de ese rango devuelven un 400 con el código invalid_request.
string
El next_page_token de la respuesta anterior. Omítalo para la primera página.
No hay parámetros de desplazamiento (offset), ni recorrido hacia la página anterior, ni recuentos totales exactos. Para contar una colección, recórrala.
Excepción: GET /v1/cohorts/{id}/members devuelve como máximo 50 filas por página, incluso cuando solicita un limit mayor. has_more y next_page_token siguen reflejando el resto real de la cohorte.
Autentíquese con cualquiera de los dos formatos de credencial Basic; consulte Guía de inicio rápido (apikey:secret o secret:). Establezca BASE con el host regional de la organización; consulte Regiones.

Recorrer una lista

Cargue LIVING_SECURITY_API_KEY desde su gestor de secretos, como en la guía de inicio rápido. Este ejemplo requiere entity:read; es posible que la clave utilizada en la guía de la primera solicitud necesite esa concesión adicional. Instale requests para Python o jq para el ejemplo de shell. Ambos ejemplos fijan una versión, mantienen los filtros sin cambios y rechazan las redirecciones. Se detienen ante errores y tras 1000 páginas, en lugar de informar de un recorrido parcial como completo. El tiempo de espera de lectura de Python limita la inactividad, no la duración total del trabajo; establezca un plazo máximo para el trabajo en su integración. Solicite páginas hasta que next_page_token sea null. Prefiera limit=500 para lecturas masivas, de modo que cubra la colección con menos solicitudes; consulte límites de frecuencia.

Mantenga estables los filtros durante la paginación

Los tokens de página son cursores firmados y opacos. Cada token está vinculado a la organización, a la cuenta de servicio autenticada, a la versión del contrato y al conjunto exacto de filtros de la solicitud que lo generó. Cambiar cualquiera de ellos a mitad del recorrido (por ejemplo, añadir un filtro type en la segunda página) devuelve un 400 con el código invalid_request en el parámetro page_token:
400 Invalid request
Para cambiar los filtros, inicie un nuevo recorrido desde la primera página.
Trate page_token como una cadena opaca: devuélvala exactamente como la recibió. No decodifique los tokens, no los almacene a largo plazo ni los construya; su formato interno puede cambiar en cualquier momento sin previo aviso.
Los endpoints de lista rechazan los parámetros de consulta que no admiten con un 400 invalid_request que indica el nombre del parámetro. Consulte la referencia de cada endpoint para conocer los filtros que admite.

Gestione una colección interrumpida o cambiante

Estos ejemplos no reintentan los errores automáticamente. Para 429, respete Retry-After y siga las pautas de reintento acotadas. Mantenga la misma región, cuenta de servicio, versión, filtros y el último token de página procesado correctamente al reintentar una lectura. Cambiar las credenciales no concede acceso: cada solicitud sigue comprobando los permisos vigentes. Una lectura de varias páginas no es una instantánea de la colección. Las filas pueden cambiar mientras la recorre. Procese los recursos por su id estable y haga que las escrituras posteriores sean idempotentes; un reinicio puede devolver de nuevo una fila. Si se rechaza un token, revise el error page_token y corrija la solicitud antes de reiniciar desde la primera página. No descarte silenciosamente los datos ya procesados ni marque como completa una exportación interrumpida. Para obtener totales de informes exactos, utilice el recurso de informes adecuado en lugar de tratar un recorrido de lista en vivo como una instantánea.