Saltar al contenido

API pública

Paginar resultados y no salirte de los límites

Los listados paginan por cursor y no por desplazamiento, así que sigue el cursor que te da la respuesta en vez de calcular uno. Vigila las cabeceras de límite y usa updatedSince para sondear en vez de releerlo todo.

Pasos

  1. Sigue el cursor de cada respuesta hasta que no devuelva ninguno. No construyas cursores por tu cuenta.
  2. Mantén un tamaño de página razonable: páginas grandes significan menos peticiones, pero más lentas.
  3. Sondea con updatedSince en vez de recorrer toda la colección periódicamente.
  4. Lee las cabeceras de límite y frena antes de que te rechacen, no después.
  5. Guarda el requestId de todo lo que falle, para soporte.

Cómo comprobar el resultado

Un recorrido completo devuelve cada objeto una vez, y un sondeo repetido lee solo lo que cambió.

Lo que suele salir mal

  • Construir páginas por desplazamiento, que se desvían cuando los datos cambian debajo.
  • Releerlo todo cada minuto y chocar con el límite.
  • Reutilizar un cursor caducado y recibir un error de cursor inválido.
¿Esto resolvió tu problema?

Esto no ayudó

Escríbenos indicando plataforma y versión, los pasos que seguiste, el resultado esperado y el espacio de trabajo o código QR implicado. Enmascara cualquier secreto antes de adjuntar nada.

Escribir a soporte