Saltar al contenido

API pública

Paginar resultados y no salirse de los límites

Los listados paginan por cursor y no por desplazamiento, así que siga el cursor que le da la respuesta en vez de calcular uno. Vigile los encabezados de límite y use updatedSince para sondear en vez de releerlo todo.

Pasos

  1. Siga el cursor de cada respuesta hasta que no devuelva ninguno. No construya cursores por su cuenta.
  2. Mantenga un tamaño de página razonable: páginas grandes significan menos peticiones, pero más lentas.
  3. Sondee con updatedSince en vez de recorrer toda la colección periódicamente.
  4. Lea los encabezados de límite y frene antes de que lo rechacen, no después.
  5. Guarde 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 vencido y recibir un error de cursor inválido.
¿Esto resolvió su problema?

Esto no ayudó

Escríbanos indicando plataforma y versión, los pasos que siguió, el resultado esperado y el espacio de trabajo o código QR involucrado. Enmascare cualquier secreto antes de adjuntar algo.

Escribir a soporte