/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.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.apikey:secret o secret:).
Establezca BASE con el host regional de la organización; consulte
Regiones.
Recorrer una lista
CargueLIVING_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 filtrotype en la segunda página) devuelve un 400 con el código
invalid_request en el parámetro page_token:
400 Invalid request
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. Para429, 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.
