Skip to main content
Toda lista de /v1 devuelve el mismo sobre, esté paginada o no:

Qué listas están paginadas

Las listas no paginadas devuelven todos los elementos en una sola página con "hasMore": false e ignoran limit y cursor. De todos modos, usa el mismo ciclo para todas las listas: si alguna pasa a estar paginada, tu código seguirá funcionando sin cambios.

Parámetros de consulta

integer
predeterminado:"50"
Cuántos elementos devolver, de 1 a 200. Solo se aceptan dígitos. Un 0, un número negativo, un decimal, un texto o un número mayor que 200 se rechaza con 400 y el código common.invalid_request.
string
El nextCursor de la página anterior, copiado tal cual. Un cursor que no se puede leer se rechaza con 400 y el código common.invalid_request; el servidor nunca vuelve en silencio a la primera página.
string
Solo en GET /v1/orders y GET /v1/fulfillments. Debe ser uno de los valores de estado indicados para esa operación en el grupo Endpoints (por ejemplo pending_approval para pedidos o dispatched para registros de entrega). Cualquier otro valor se rechaza con 400 y el código common.invalid_request.
string
Solo en GET /v1/inventory/balances: conserva las cajas de un insumo del catálogo. Un id que no coincide con nada devuelve una página vacía.
string
Solo en GET /v1/inventory/balances: conserva las cajas de una bodega. Un id que no coincide con nada devuelve una página vacía.

Recorre todas las páginas

Última página

Reglas del cursor

  • El cursor es opaco. Trátalo como un token. No lo decodifiques, no lo construyas ni lo modifiques; su formato puede cambiar sin aviso.
  • Un cursor marca una posición, no un número de página. La página siguiente empieza justo después del último elemento que recibiste. Los elementos creados mientras recorres la lista no se saltan ni se repiten: los pedidos y registros de entrega nuevos aparecen al final, porque esas listas van del más antiguo al más reciente.
  • Envía los mismos filtros en cada página. El cursor guarda solo la posición. Si cambias status, catalogItemId o warehouseId a mitad de camino, la página siguiente aplica los filtros nuevos desde esa posición.
  • Los filtros se aplican en cada solicitud. Si un pedido cambia de estado mientras recorres GET /v1/orders?status=approved, puede salir del filtro antes de que llegues a él.
  • Usa un cursor solo con la operación que lo emitió. Un cursor de una lista no sirve en otra.
  • Usa limit=200 para recorridos completos. Menos páginas, más grandes, consumen menos de tu presupuesto de solicitudes (consulta Límites de uso).

Errores

Páginas relacionadas