Paginación¶
Todos los recursos de nivel superior de la API pueden obtenerse por lotes mediante los métodos de listado.
Por ejemplo, puede listar inquilinos, recursos y las políticas de copia de seguridad disponibles.
Estos métodos de listado comparten una estructura común: aceptan al menos dos parámetros, limit y page_token, y devuelven next_page_token.
El parámetro limit define cuántos objetos se deben devolver en una sola llamada a la API.
El número exacto de objetos devueltos puede diferir del solicitado y ser inferior.
Además, en algunos casos el parámetro limit puede ignorarse por completo, normalmente cuando se proporciona un valor limit inadecuado (por ejemplo, limit = 0).
No dé por finalizado el listado hasta que el valor next_page_token devuelto en la respuesta esté vacío.
El parámetro page_token define el punto de inicio del listado. Envíe el valor next_page_token de la respuesta anterior para continuar el listado después del último objeto devuelto.
Ejemplo¶
Al realizar una solicitud GET al punto de conexión paginado https://papi.afi.ai/api/v1/applications/me/installations, recibirá una respuesta similar a esta:
Para obtener la página siguiente de resultados, tome el valor next_page_token del cuerpo de la respuesta y envíelo al mismo punto de conexión en el parámetro de consulta page_token: